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Preface 


The material in this guide is organized into two major parts: an overview of 
the UNIX operating system and a set of tutorials on the main tools available on 
the UNIX system. A brief description of each part follows. The last section of 
this Preface, "Notation Conventions," describes the typographical notation with 
which all the chapters of this Guide conform. You may want to refer back to this 
section from time to time as you read the Guide. 


System Overview 


This part consists of Chapters 1—3, which introduce you to the basic princi- 
ples of the UNIX operating system. Each chapter builds on information 
presented in preceding chapters, so it is important to read them in sequence. 


@ Chapter 1, "What is the UNIX System?," provides an overview of the 
operating system. 


™@ Chapter 2, "Basics for UNIX System Users," discusses the general rules 
and guidelines for using the UNIX system. It covers topics related to 
using your terminal, obtaining a system account, and establishing contact 
with the UNIX system. 


= Chapter 3, "Using the File System," offers a working perspective of the file 
system. It introduces commands for building your own directory structure, 
accessing and manipulating the subdirectories and files you organize within 
it, and examining the contents of other directories in the system for which 
you have access permission. 


UNIX System Tutorials 


The second part of the Guide consists of tutorials on the following topics: the 
ed text editor, the vi text editor, the shell command language and programming 
language, and electronic communication tools. For a thorough understanding of 
the material, we recommend that you work through the examples and exercises as 
you read each tutorial. The tutorials assume you understand the concepts intro- 
duced in Chapters 1-3. . 
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™ Chapter 4, "UNIX System Capabilities," introduces the four chapters of 
tutorials in the second half of the Guide. It highlights UNIX system capa- 
bilities such as command execution, text editing, electronic communication, 
programming, and aids to software development. 


™ Chapter 5, "Line Editor Tutorial (ed)," teaches you to how to use the ed 
text editor to create and modify text on a video display terminal or paper 
printing terminal. 


™ Chapter 6, "Screen Editor Tutorial (vi)," teaches you how to use the visual 
text editor, vi, to create and modify text on a video display terminal. 


nia, Berkeley, California; Computer Science Division, Department of Electrical 
Engineering and Computer Science, and such software is owned and licensed by 
the Regents of the University of California. 


sem vi, the visual editor, is based on software developed by The University of Califor- 
NOTE 


™ Chapter 7, "Shell Tutorial," teaches you to how to use the shell, both as a 
command interpreter and as a programming language used to create shell 
programs. 


™ Chapter 8, "Communication Tutorial," teaches you how to send messages 
and files to users of both your UNIX system and other UNIX systems. 


Reference Information 
Six appendices and a glossary of UNIX system terms are also provided for 
reference. 


™ Appendix A, "Summary of the File System," illustrates how information is 
stored in the UNIX operating system. 


= Appendix B, "Summary of UNIX System Commands," describes, in 
alphabetical order, each UNIX system command discussed in the Guide. 
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Appendix C, "Quick Reference to ed Commands," is a quick reference for 
the line editor, ed. (For details, see Chapter 5, "Line Editor Tutorial.") 
The commands are organized by topic, as they are covered in Chapter 5. 


Appendix D, "Quick Reference to vi Commands," is a reference for the 
full screen editor, vi, discussed in Chapter 6, "Screen Editor Tutorial (vi)." 
Commands are organized by topic, as covered in Chapter 6. 


Appendix E, "Summary of Shell Command Language," is a summary of 
the shell command language, notation, and programming constructs, as dis- 
cussed in Chapter 7, "Shell Tutorial." 


Appendix F, "Setting Up the Terminal," explains how to configure your 
terminal for use with the UNIX system, and create multiple windows on 
the screens of terminals with windowing capability. 


The Glossary defines terms pertaining to the UNIX system used in this 
book. 
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Notation Conventions 


The following notation conventions are used throughout this Guide. 


bold 


italic 


constant width 


<> 


<“char> 


User input, such as commands, options and argu- 
ments to commands, variables, and the names of 
directories and files, appear in bold. 


Names of variables to which values must be assigned 
(such as password) appear in italic. 


UNIX system output, such as prompt signs and 
responses to commands, appear in constant width. 


Input that does not appear on the screen when typed, 
such as passwords, tabs, or RETURN, appear 
between angle brackets. 


Control characters are shown between angle brackets 
because they do not appear on the screen when 
typed. The circumflex (*) represents the control key 
(usually labeled CTRL). To type a control charac- 
ter, hold down the control key while you type the 
character specified by char. For example, the nota- 
tion <“d> means to hold down the control key 
while pressing the D key; the letter D will not 
appear on the screen. 


Command options and arguments that are optional, 
such as [-msCjl, are enclosed in square brackets. 


The vertical bar separates optional arguments from 
which you may choose one. For example, when a 
command line has the following format: 


command [arg] | arg2] 


You may use either arg] or arg2 when you issue the 
command. 


PREFACE xv 


Notation Conventions 


Ellipses after an argument mean that more than one 
argument may be used on a single command line. 


Arrows on the screen (shown in examples in Chapter 
6) represent the cursor. 


command (number) A command name followed by a number in 
parentheses refers to the part of a UNIX system 
reference manual that documents that command. 
(There are three reference manuals: the User’s 
Reference Manual (P-H), Programmer’s Reference 
Manual (P-H), and System Administrator’s Refer- 
ence Manual (AT &T).) For example, the notation 
cat(1) refers to the page in section 1 (of the User’s 
Reference Manual (P-H)) that documents the cat 
command. 


In sample commands the §$ sign is used as the shell command prompt. This 
is not true for all systems. Whichever symbol your system uses, keep in mind that 
prompts are produced by the system; although a prompt is sometimes shown at 
the beginning of a command line as it would appear on your screen, you are not 
meant to type it. (The $ sign is also used to reference the value of positional 
parameters and named variables; see Chapter 7 for details.) 


In all chapters, full and partial screens are used to display examples of how 
your terminal screen will look when you interact with the UNIX system. These 
examples show how to use the UNIX system editors, write short programs, and 
execute commands. The input (characters typed by you) and output (characters 
printed by the UNIX system) are shown in these screens in accordance with the 
conventions listed above. All examples apply regardless of the type of terminal 
you use. 


The commands discussed in each section of a chapter are reviewed at the end 
of that section. A summary of vi commands is found in Appendix D, where they 
are listed by topic. At the end of some sections, exercises are also provided so you 
can experiment with the commands. The answers to all the exercises in a chapter 
are at the end of that chapter. 
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described in the Guide and formatted with the DOCUMENTER’S WORK- 


som The text in the User’s Guide was prepared with the UNIX system text editors 
NOTE 
BENCH Software: troff, tbl, pic, and mm macros. 
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CHAPTER 1: WHAT IS THE UNIX SYSTEM? 


What the UNIX System Does 


The UNIX operating system is a set of programs (or software) that controls 
the computer, acts as the link between you and the computer, and provides tools 
to help you do your work. It is designed to provide an uncomplicated, efficient, 
and flexible computing environment. Specifically, the UNIX system offers the fol- 
lowing advantages: 


™ a general purpose system for performing a wide variety of jobs or applica- 
tions 


™ an interactive environment that allows you to communicate directly with 
the computer and receive immediate responses to your requests and mes- 
sages 


@ a multi-user environment that allows you to share the computer’s resources 
with other users without sacrificing productivity 


This technique is called timesharing. The UNIX system interacts between 
users on a rotating basis so quickly that it appears to be interacting with 
all users simultaneously. 


@ a multi-tasking environment that enables you to execute more than one 
program simultaneously. 


The organization of the UNIX system is based on four major components: 


the kernel The kernel is a program that constitutes the nucleus of 
the operating system; it coordinates the functioning of 
the computer’s internals (such as allocating system 
resources). The kernel works invisibly; you need never 
be aware of it while doing your work. 


the file system The file system provides a method of handling data that 
makes it easy to store and access information. 


the shell The shell is a program that serves as the command inter- 
preter. It acts as a liaison between you and the kernel, 
interpreting and executing your commands. Because it 
reads input from you and sends you messages, it is 
described as interactive. 
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commands 
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Commands are the names of programs that you request 
the computer to execute. Packages of programs are 
called tools. The UNIX system provides tools for jobs 
such as creating and changing text, writing programs 
and developing software tools, and exchanging informa- 
tion with others via the computer. 


How the UNIX System Works 


Figure 1-1 is a model of the UNIX system. Each circle represents one of the 
main components of the UNIX system: the kernel, the shell, and user programs or 
commands. The arrows suggest the shell’s role as the medium through which you 
and the kernel communicate. The remainder of this chapter describes each of 
these components, along with another important feature of the UNIX system, the 
file system. 


Programming 
Environment 


Text 
Processing 


Electronic 
Communication 


Additional . 
Utility Information 


Programs Management 


Figure 1-1: Model of the UNIX System 
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The Kernel 


The nucleus of the UNIX system is called the kernel. The kernel controls 
access to the computer, manages the computer’s memory, maintains the file sys- 
tem, and allocates the computer’s resources among users. Figure 1-2 is a func- 
tional view of the kernel. 


& 
oe 
\~ Allocates 
system 
resources 
Manages Maintains 
memory file system 


Controls 
access to 
computer 


Figure 1-2: Functional View of the Kernel 
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The File System 


The file system is the cornerstone of the UNIX operating system. It provides 
a logical method of organizing, retrieving, and managing information. The struc- 
ture of the file system is hierarchical; if you could see it, it might look like an 
organization chart or an inverted tree (Figure 1-3). 


C) = Directories 
iz = Ordinary Files 
V/ = Specia! Files 


Figure 1-3: The Hierarchical Structure of the File System 


The file is the basic unit of the UNIX system and it can be any one of three 
types: an ordinary file, a directory, or a special file. (See Chapter 3, "Using the 
File System.") 


Ordinary Files 


An ordinary file is a collection of characters that is treated as a unit by the 
system. Ordinary files are used to store any information you want to save. They 
may contain text for letters or reports, code for the programs you write, or com- 
mands to run your programs. Once you have created a file, you can add material 
to it, delete material from it, or remove it entirely when it is no longer needed. 
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Directories 


A directory is a super-file that contains a group of related files. For example, 
a directory called sales may hold files containing monthly sales figures called jan, 
feb, mar, and so on. You can create directories, add or remove files from them, or 
remove directories themselves at any time. 


All the directories that you create and own will be located in your home 
directory. This is a directory assigned to you by the system when you receive a 
recognized login. You have control over this directory; no one else can read or 
write files in it without your explicit permission, and you determine its structure. 


The UNIX system also maintains several directories for its own use. The 
structure of these directories is much the same on all UNIX systems. These 
directories, which include /unix (the kernel) and several important system direc- 
tories, are located directly under the root directory in the file hierarchy. The root 
directory (designated by /) is the source of the UNIX file structure; all directories 
and files are arranged hierarchically under it. 


Special Files 


Special files constitute the most unusual feature of the file system. A special 
file represents a physical device such as a terminal, disk drive, magnetic tape 
drive, or communication link. The system reads and writes to special files in the 
_ same way it does to ordinary files. However the system’s read and write requests 
do not activate the normal file access mechanism; instead, they activate the device 
handler associated with the file. 


Some operating systems require you to define the type of file you have and to 
use it in a specified way. In those cases, you must consider how the files are 
stored since they might be sequential, random-access, or binary files. To the 
UNIX system, however, all files are alike. This makes the UNIX system file 
structure easy to use. For example, you need not specify memory requirements 
for your files since the system automatically does this for you. Or if you or a pro- 
gram you write needs to access a certain device, such as a printer, you specify the 
device just as you would another one of your files. In the UNIX system, there is 
only one interface for all input from you and output to you; this simplifies your 
interaction with the system. 
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Figure 1-4 shows an example of a typical file system. Notice that the root 
directory contains the kernel (/unix) and several important system directories. 


Mie salto o & 
BIE vaAvaw Ole 


& = Directories 
[ = Ordinary Files 
\/ = Special Files 


Figure 1-4: Example of a File System 
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| /bin contains many executable programs and utilities 

/dev contains special files that represent peripheral devices such as the 
console, the line printer, user terminals, and disks 

/etc contains programs and data files for system administration 

Nib contains libraries for programs and languages 

/tmp contains temporary files that can be created by any user 

/usr contains other directories including mail, which contains files for 


storing electronic mail, and news, which contains files for storing 
newsworthy items. 


In summary, the directories and files you create comprise the portion of the 
file system that is controlled by you. Other parts of the file system are provided 
and maintained by the operating system, such as /bin, /dev, /etc, /lib, /tmp and 
/usr, and have much the same structure on all UNIX systems. 


You will learn more about the file system in other chapters. Chapter 3 shows 
how to organize a file system directory structure, and access and manipulate files. 
Chapter 4 gives an overview of UNIX system capabilities. The effective use of 
these capabilities depends on your familiarity with the file system and your ability 
to access information stored within it. Chapters 5 and 6 are tutorials designed to 
teach you how to create and edit files. 


The Shell 


The shell is a unique command interpreter that allows you to communicate 
with the operating system. The shell reads the commands you enter and inter- 
prets them as requests to execute other programs, access files, or provide output. 
The shell is also a powerful programming language, not unlike the C program- 
ming language, that provides conditional execution and control flow features. The 
model of a UNIX system in Figure 1-1 shows the two-way flow of communication 
between you and the computer via the shell. 
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Chapter 4 describes the shell’s capabilities. Chapter 7 is a tutorial that 
teaches you to write simple shell programs called shell scripts and custom tailor 
your environment. 


Commands 


A program is a set of instructions to the computer. Programs that can be 
executed by the computer without need for translation are called executable pro- 
grams or commands. As a typical user of the UNIX system, you have many 
standard programs and tools available to you. If you use the UNIX system to 
write programs and develop software, you can also draw on system calls, subrou- 
tines, and other tools. Of course, any programs you write yourself will be at your 
disposal, too. 


This book introduces you to many of the UNIX system programs and tools 
that you will use on a regular basis. If you need additional information on these 
or other standard programs, refer to the User’s Reference Manual. For informa- 
tion on tools and routines related to programming and software development, con- 
sult the Programmer’s Reference Manual. The Documentation Roadmap 
describes and explains how to order all UNIX system documents from AT&T. 


The reference manuals may also be available online. (Online documents are 
stored in your computer’s file system.) You can summon pages from the online 
manuals by executing the command man (short for manual page). For details on 
how to use the man command refer to the man(1) page in the User’s Reference 
Manual. 


What Commands Do 


The outer circle of the UNIX system model in Figure 1-1 organizes the sys- 
tem programs and tools into functional categories. These functions include: 


text processing The system provides programs such as line 
and screen editors for creating and changing 
text, a spelling checker for locating spelling 
errors, and optional text formatters for pro- 
ducing high-quality paper copies that are 
suitable for publication. 


information management The system provides many programs that 
allow you to create, organize, and remove 
files and directories. 


WHAT IS THE UNIX SYSTEM? 389 


How the UNIX System Works 


electronic communication Several programs, such as mail, enable you 
to transmit information to other users and to 
other UNIX systems. 


software development Several UNIX system programs establish a 
friendly programming environment by pro- 
viding UNIX-to-programming-language 
interfaces and by supplying numerous utility 
programs. 


additional utilities The system also offers capabilities for gen- 
erating graphics and performing calcula- 
tions. 


How to Execute Commands 


To make your requests comprehensible to the UNIX system, you must 
present each command in the correct format, or command line syntax. This syn- 
tax defines the order in which you enter the components of a command line. Just 
as you must put the subject of a sentence before the verb in an English sentence, 
so must you put the parts of a command line in the order required by the com- 
mand line syntax. Otherwise, the UNIX system shell will not be able to interpret 
your request. Here is an example of the syntax of a UNIX system command line. 


command option(s) argument(s)<CR> 
On every UNIX system command line you must type at least two com- 
ponents: a command name and the RETURN key. (The notation <CR> is 
used as an instruction to press the RETURN key throughout this Guide.) A com- 


mand line may also contain either options or arguments, or both. What are com- 
mands, options, and arguments? 


™@ a command is the name of the program you want to run 


™ an option modifies how the command runs 
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™ an argument specifies data on which the command is to operate (usually 
the name of a directory or file) 


In command lines that include options and/or arguments, the component 
words are separated by at least one blank space. (You can insert a blank by 
pressing the space bar.) If an argument name contains a blank, enclose that name 
in double quotation marks. For example, if the argument to your command is 
sample 1, you must type it as follows: "sample 1". If you forget the double quota- 
tion marks, the shell will interpret sample and 1 as two separate arguments. 


Some commands allow you to specify multiple options and/or arguments on a 
command line. Consider the following command line: 


command 
arguments 


options 


eS AS SS eS See 
we —l —w filel file2 file3 


In this example, we is the name of the command and two options, —I and 
—w, have been specified. (The UNIX system usually allows you to group options 
such as these to read —lw if you prefer.) In addition, three files (filel, file2, and 
file3) are specified as arguments. Although most options can be grouped together, 
arguments cannot. 

The following examples show the proper sequence and spacing in command 


line syntax: 
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Incorrect | Correct 
wefile we file 
we —lfile we —1 file 
we —l w file we —Iw file 
or 
we —1 —w file 
we filelfile2 we filel file2 


Remember, regardless of the number of components, you must end every 
command line by pressing the RETURN key. 


How Commands Are Executed 


Figure 1-5 shows the flow of control when the UNIX system executes a com- 


mand. 


YOUR 
REQUEST 


SHELL 


DIRECTORY 
SEARCH 
PROGRAM PROGRAM 
EXECUTION RETRIEVAL 


(COMMAND 
LANGUAGE 
INTERPRETER) 


OUTPUT 


ome 
= 


EXECUTABLE 
PROGRAMS 


Figure 1-5: Execution of a UNIX System Command 


To execute a command, enter a command line when a prompt (such as a $ 
sign) appears on your screen. The shell considers your command as input, 
searches through one or more directories to retrieve the program you specified, 
and conveys your request, along with the program requested, to the kernel. The 
kernel then follows the instructions in the program and executes the command you 
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requested. After the program has finished running, the shell signals that it is 
ready for your next command by printing another prompt. 


This chapter has described some basic principles of the UNIX operating sys- 
tem. The following chapters will help you apply these principles according to 
your computing needs. 
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CHAPTER 2: BASICS FOR UNIX SYSTEM USERS 


Getting Started 


This chapter acquaints you with the general rules and guidelines for working 
on the UNIX system. Specifically, it lists the required terminal settings, and 
explains how to use the keyboard, obtain a login, log on and off the system, and 
enter simple commands. 


To establish contact with the UNIX system, you need: 
@ a terminal 


™ a login name (a name by which the UNIX system identifies you as one of 
its authorized users) 


™ a password that verifies your identity 
™ instructions for dialing in and accessing the UNIX system if your terminal 


is not directly connected or hard-wired to the computer 


This chapter follows the notation conventions used throughout this Guide. 
For a description of them, see the Preface. 
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A terminal is an input/output device: you use it to enter requests to the 
UNIX system, and the system uses it to send its responses to you. There are two 
basic types of terminals: video display terminals and printing terminals (see Fig- 
ure 2-1). 


Teletype 


Teletype Model 43 


Model 5410 


Figure 2-1: A Video Display Terminal and a Printing Terminal 


The video display terminal shows input and output on a display screen; the print- 
ing terminal, on continuously fed paper. In most respects, this difference has no 
effect on the user’s actions or the system’s responses. Instructions throughout this 
book that refer to the terminal screen apply in the same way to the paper in a 
printing terminal, unless noted otherwise. 
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Required Terminal Settings 


Regardless of the type of terminal you use, you must configure it properly to 
communicate with the UNIX system. If you have not set terminal options before, 
you might feel more comfortable seeking help from someone who has. 


How you configure a terminal depends on the type of terminal you are using. 
Some terminals are configured with switches; others are configured directly from 
the keyboard by using a set of function keys. To determine how to configure your 
terminal, consult the owner’s manual provided by the manufacturer. 


The following is a list of configuration checks you should perform on any ter- 
minal before trying to log in on the UNIX system. 


1. Turn on the power. 


2. Set the terminal to ON-LINE or REMOTE operation. This setting 
ensures the terminal is under the direct control of the computer. 


3. Set the terminal to FULL DUPLEX mode. This mode ensures two-way 
communication (input/output) between you and the UNIX system. 


4. If your terminal is not directly connected or hard-wired to the computer, 
make sure the acoustic coupler or data phone set you are using is set to 
the FULL DUPLEX mode. 


5. Set character generation to LOWER CASE. If your terminal generates 
only upper case letters, the UNIX system will accommodate it by print- 
ing everything in upper case letters. 


6. Set the terminal to NO PARITY. 


7. Set the baud rate. This is the speed at which the computer communi- 
cates with the terminal, measured in characters per second. (For exam- 
ple, a terminal set at a baud rate of 4800 sends and receives 480 charac- 
ters per second.) Depending on the computer and the terminal, baud rates 
between 300 and 19200 are available. Some computers may be capable 
of processing characters at higher speeds. 
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Keyboard Characteristics 


There is no standard layout for terminal keyboards. However, all terminal 
keyboards share a standard set of 128 characters called the ASCII character set. 
(ASCII is an acronym for American Standard Code for Information Inter- 
change.) While the keys are labeled with characters that are meaningful to you 
(such as the letters of the alphabet), each one is also associated with an ASCII 
code that is meaningful to the computer. 


The keyboard layout on a typical ASCII terminal is basically the same as a 
typewriter’s, with a few additional keys for functions such as interrupting tasks. 
Figure 2-2 shows an example of a keyboard on an ASCII terminal. 
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Figure 2-2: Keyboard Layout of a Teletype 5410 Terminal 
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The keys correspond to the following: 
™ the letters of the English alphabet (both upper case and lower case) 
™ the numerals (0 through 9) 


™ a variety of symbols (including! @ #$%" &() -+=~ {3 ]]\ 
eS PY) 


™ specially defined words (such as RETURN and BREAK), and abbrevia- 
tions (such as DEL for delete, CTRL for control, and ESC for escape) 


While terminal and typewriter keyboards both have alphanumeric keys, ter- 
minal keyboards also have keys designed for use with a computer. These keys are 
labeled with characters or symbols that remind the user of their functions. How- 
ever, their placement may vary from terminal to terminal because there is no 
standard keyboard layout. 


Typing Conventions 


To interact effectively with the UNIX system, you should be familiar with its 
typing conventions. The UNIX system requires that you enter commands in 
lower case letters (unless the command includes an upper case letter). Other con- 
ventions enable you to perform tasks, such as erasing letters or deleting lines, sim- 
ply by pressing one key or entering a specific combination of characters. Charac- 
ters associated with tasks in this way are known as special characters. Figure 2-3 
lists the conventions based on special characters. Detailed explanations of them 
are provided on the next few pages. 
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Meaning 


System’s command prompt (your cue to issue a command) 
Erase a character 


Erase or kill an entire line 


<BREAK> _— Stop execution of a program or command 


<DEL> Delete or kill the current command line 


<ESC> When used with another character, performs a specific function 
(called an escape sequence) 


When used in an editing session with the vi editor, ends the text 
input mode and returns you to the command mode 


Press the RETURN key. This ends a line of typing and puts the 
cursor on a new line. 


Stop input to the system or log off 

Backspace for terminals without a backspace key 
Horizontal tab for terminals without a tab key 
Temporarily stops output from printing on the screen 


Makes the output resume printing on the screen after it has been 
stopped by the <“s> command 


Nonprinting characters are shown in angle brackets (< >). 
t Characters preceded by a circumflex (*) are called control characters and are pronounced 


control-/etter. To type a control character, hold down the control key and press the specified 
letter. 


Figure 2-3: UNIX System Typing Conventions 
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The Command Prompt 


The standard UNIX system command prompt is the dollar sign ($). When 
the prompt appears on your terminal screen, the UNIX system is waiting for 
instructions from you. The appropriate response to the prompt is to issue a com- 
mand and press the RETURN key. 


The §$ sign is the default value for the command prompt. Chapter 7 explains 
how to change it if you would prefer another character or character string as your 
command prompt. 


Correcting Typing Errors 


There are two keys you can use to delete text so that you can correct typing 
errors. The @ (at) sign key kills the current line and the # (pound) sign key 
erases the last character typed. These keys are available by default to perform 
these functions. However, if you want to use other keys, you can reassign the 
erase and kill functions. (For instructions, see "Reassigning the Delete Functions" 
later in this section and "Setting Terminal Options" in Chapter 7.) 


Deleting the Current Line: the @ Sign 


The @ sign key kills the current line. When you press it, an @ sign is added 
to the end of the line, and the cursor moves to the next line. The line containing 
the error is not erased from the screen but is ignored. 


The @ sign key works only on the current line; be sure to press it before you 
press the RETURN key if you want to kill a line. In the following example, a 
misspelled command is typed on a command line; the command is cancelled with 
the @ sign: 


whooo@ 
who <CR> 
Deleting the Last Characters Typed: the # Sign Key 


The # (pound) sign key deletes the character(s) last typed on the current line. 
When you type a # sign, the cursor backs up over the last character and lets you 
retype it, thus effectively erasing it. This is an easy way to correct a typing error. 
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You can delete as many characters as you like as long as you type a corre- 
sponding number of # signs. For example, in the following command line, two 
characters are deleted by typing two # signs. 


dattw##e<CR> 


The UNIX system interprets this as the date command, typed correctly. 
The BACKSPACE Key 


Many people prefer to use the BACKSPACE key for the erase function 
instead of the # sign key. When you press the BACKSPACE key, the cursor 
backs up over your errors, erasing them as it goes. It does not print anything, 
unlike the # sign key, which prints a # sign on your screen between an error and a 
correction. When you have finished correcting an error with the BACKSPACE 
key, the line of text on the screen looks as though it was typed perfectly. 


The # sign and BACKSPACE keys are equally effective at deleting charac- 
ters, but using the BACKSPACE key gives you better visual information about 
what you are doing. 


som Some terminals may not recognize the # sign key as a delete character. 
NOTE 


Reassigning the Delete Functions 

As stated earlier, you can change the keys that kill lines and erase characters. 
If you want to change these keys for a single working session, you can issue a 
command to the shell to reassign them; the delete functions will revert to the 
default keys (# and @) as soon as you log off. If you want to use other keys regu- 
larly, you must specify the reassignment in a file called .profile. Instructions for 
making both temporary and permanent key reassignments, along with a descrip- 
tion of the .profile, are given in Chapter 7. 


There are three points to keep in mind if you reassign the delete functions to 
non-default keys. First, the UNIX system allows only one key at a time to per- 
form a delete function. When you reassign a function to a non-default key, you 
also take that function away from the default key. For example, if you reassign 
the erase function from the # sign key to the BACKSPACE key, you will no 
longer be able to use the # sign key to erase characters. Neither will you have 
two keys that perform the same function. 
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Secondly, such reassignments are inherited by any other UNIX system pro- 
gram that allows you to perform the function you have reassigned. For example, 
the interactive text editor called ed (described in Chapter 5) allows you to delete 
text with the same key you use to correct errors on a shell command line (as 
described in this section). Therefore, if you reassign the erase function to the 
BACKSPACE key, you will have to use the BACKSPACE key to erase charac- 
ters while working in the ed editor, as well. The # sign key will no longer work. 


Finally, keep in mind that any reassignments you have specified in your 
-profile do not become effective until after you log in. Therefore, if you make an 
error while typing your login name or password, you must use the # sign key to 
correct it. 


Whichever keys you use, remember that they work only on the current line. 
Be sure to correct your errors before pressing the RETURN key at the end of a 
line. 


Using Special Characters as Literal Characters 


What happens if you want to use a special character in with literal meaning 
as a unit of text? Since the UNIX system’s default behavior is to interpret spe- 
cial characters as commands, you must tell the system to ignore or escape from a 
character’s special meaning whenever you want to use it as a literal character. 
The backslash (\) enables you to do this. Type a \ before any special character 
that you want to have treated as it appears. By doing this you essentially tell the 
system to ignore this character’s special meaning and treat it as a literal unit of 
text. : 


For example, suppose you want to add the following sentence to a file: 
Only one # appears on this sheet of music. 


To prevent the UNIX system from interpreting the # sign as a request to delete a 
character, enter a \ in front of the # sign. If you do not, the system will erase the 
space after the word one and print your sentence as follows: 


Only one appears on this sheet of music. 
To avoid this, type your sentence as follows: 


Only one \# appears on this sheet of music. 
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Typing Speed 


After the prompt appears on your terminal screen, you can type as fast as you 
want, even when the UNIX system is executing a command or responding to one. 
Since your input and the system’s output appear on the screen simultaneously, the 
printout on your screen will appear garbled. However, while this may be incon- 
venient for you, it does not interfere with the UNIX system’s work because the 
UNIX system has read-ahead capability. This capability allows the system to 
handle input and output separately. The system takes and stores input (your next 
request) while it sends output (its response to your last request) to the screen. 


Stopping a Command 


If you want to stop the execution of a command, simply press the BREAK or 
DELETE key. The UNIX system will stop the program and print a prompt on 
the screen. This is its signal that it has stopped the last command from running 
and is ready for your next command. 


Using Control Characters 


Locate the control key on your terminal keyboard. It may be labeled CON- 
TROL or CTRL and is probably to the left of the A key or below the Z key. 
The control key is used in combination with other characters to perform physical 
controlling actions on lines of typing. Commands entered in this way are called 
control characters. Some control characters perform mundane tasks such as back- 
spacing and tabbing. Others define commands that are specific to the UNIX sys- 
tem. For example, one control character (control-s) temporarily halts output that 
is being printed on a terminal screen. 


To type a control character, hold down the control key and press the 
appropriate alphabetic key. Most control characters do not appear on the screen 
when typed and therefore are shown between angle brackets (see "Notation Con- 
ventions" in the Preface). The control key is represented by a circumflex (*) 
before the letter. Thus, for example, <“s> designates the control-s character. 
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The two functions for which control characters are most often used are to 
control the printing of output on the screen and to log off the system. To prevent 
information from rolling off the screen on a video display terminal, type <“s>; 
the printing will stop. When you are ready to read more output, type <“q> and 
the printing will resume. 


To log off the UNIX system, type <“d>. (See "Logging Off" later in this 
chapter for a detailed description of this procedure.) 


In addition, the UNIX system uses control characters to provide capabilities 
that some terminals fail to make available through function specific keys. If your 
keyboard does not have a backspace key, you can use the <‘h> key instead. 
You can also set tabs without a tab key by typing <“i> if your terminal is set 
properly. (Refer to the section entitled "Possible Problems When Logging In" for 
information on how to set the tab key.) 


Now that you have configured the terminal and inspected the keyboard, one 
step remains before you can establish communication with the UNIX system: 
you must obtain a login name. 
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A login name is the name by which the UNIX system verifies that you are an 
authorized user of the system when you request access to it. It is so called 
because you must enter it every time you want to log in. (The expression logging 
in is derived from the fact that the system maintains a log for each user, in which 
it records the type and amount of system resources being used.) 


To obtain a login name, set up a UNIX system account through your local 
system administrator. There are few rules governing your choice of a login name. 
Typically, it is three to eight characters long. It can contain any combination of 
lower case alphanumeric characters, as long as it starts with a letter. It cannot 
contain any symbols. 


However, your login name will probably be determined by local practices. 
The users of your system may all use their initials, last names, or nicknames as 
their login names. Here are a few examples of legal login names: starship, mary2, 
and jmrs. 
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Typically, you will be using either a terminal that is wired directly to a com- 
puter or a terminal that communicates with a computer over a telephone line. 


This section describes a typical procedure for logging in, but may not apply to 
your system. There are many ways to log in on a UNIX system over a telephone 
line. Security precautions on your system may require that you use a special 
telephone number or other security code. For instructions on logging in on your 
UNIX system from outside your computer installation site, see your system 
administrator. 


Turn on your terminal. If it is directly connected, the login: prompt will 
immediately appear in the upper lefthand corner of the screen. 


If you are going to communicate with the computer over a telephone line, you 
must now establish a connection. The following procedure is an example of a 
method you might use to do this. (For the procedure required by your system, see 
your system administrator.) 


1. 


Dial the telephone number that connects you to the UNIX system. You 
will hear one of the following: 


> A busy signal. This means that either the circuits are busy or the line 
is in use. Hang up and dial again. 


« Continuous ringing and no answer. This usually means that there is 
trouble with the telephone line or that the system is inoperable 
because of mechanical failure or electronic problems. Hang up and 
dial again later. 


a A high-pitched tone. This means that the system is accessible. 


When you hear the high-pitched tone, place the handset of the phone in 
the acoustic coupler or momentarily press the appropriate button on the 
data phone set (see the owner’s manual for the appropriate equipment). 
Then replace the handset in the cradle (see Figure 2-4). 


After a few seconds, the login: prompt will appear in the upper lefthand 
corner of the screen. 
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4. A series of meaningless characters may appear on your screen. This 
means that the telephone number you called serves more than one baud 
rate; the UNIX system is trying to communicate with your terminal, but 
is using the wrong speed. Press the BREAK or RETURN key; this sig- 
nals the system to try another speed. If the UNIX system does not 
display the login: prompt within a few seconds, press the BREAK or 
RETURN key again. 


AT&T Data Phone 
Set 212A 


AT&T Acoustic 
Coupler 


AT&T Dataphone II 
Modem 


Figure 2-4: Data Phone Set, Modem, and Acoustic Coupler 
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Login Procedure 


When the login: prompt appears, type your login name and press the 
RETURN key. For example, if your login name is starship, your login line will 
look like this: 


login: starship<CR> 


log in, the UNIX system will expect and respond in upper case exclusively until 
the next time you log in. It will accept and run many commands typed in upper 
case, but will not allow you to edit files. 


pom Remember to type in lower case letters. If you use upper case from the time you 
NOTE 


Password 


Next, the system prompts you for your password. Type your password and 
press the RETURN key. For security reasons, the UNIX system does not print 
(or echo) your password on the screen. 


If both your login name and password are acceptable to the UNIX system, 
the system may print the message of the day and/or current news items and then 
the default command prompt ($). (The message of the day might include a 
schedule for system maintenance, and news items might include an announcement 
of a new system tool.) When you have logged in, your screen will look similar to 
this: 
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login: starship<CR> 
password: 
UNIX system news 


$ 


If you make a typing mistake when logging in, the UNIX system prints the 
message login incorrect on your screen. Then it gives you a second chance to 
log in by printing another login: prompt. 


login: ttarship<CR> 
password: 
login incorrect 


login: 


The login procedure may also fail if the communication link between your 
terminal and the UNIX system has been dropped. If this happens, you must rees- 
tablish contact with the computer (specifically, with the data switch that links 
your terminal to the computer) before trying to log in again. Since procedures for 
doing this vary from site to site, ask your system administrator to give you exact 
instructions for getting a connection on the data switch. 


If you have never logged in on the UNIX system, your login procedure may 
differ from the one just described. This is because some system administrators 
follow the optional security procedure of assigning temporary passwords to new 
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users when they set up their accounts. If you have a temporary password the sys- 
tem will force you to choose a new password before it allows you to log in. 


By forcing you to choose a password for your exclusive use, this extra step 
helps to ensure a system’s security. Protection of system resources and your per- 
sonal files depends on your keeping your password private. 


The actual procedure you follow will be determined by the administrative pro- 
cedures at your computer installation site. However, it will probably be similar to 
the following example of a first-time login procedure. 


1. You establish contact; the UNIX system displays the login: prompt. 
Type your login name and press the RETURN key. 


2. The UNIX system prints the password prompt. Type your temporary 
password and press the RETURN key. 


3. The system tells you your temporary password has expired and you must 
select a new one. 


4. The system asks you to type your old password again. Type your tem- 
porary password. 


5. The system prompts you to type your new password. Type the password 
you have chosen. 


Passwords must be constructed to meet the following requirements: 


« Each password must have at least six characters. Only the first eight 
characters are significant. 


« Each password must contain at least two alphabetic characters and at 
least one numeric or special character. Alphabetic characters can be 
upper case or lower case letters. 


> Each password must differ from your login name and any reverse or 
circular shift of that login name. For comparison purposes, an upper 
case letter and its corresponding lower case letter are equivalent. 


« A new password must differ from the old by at least three characters. 
For comparison purposes, an upper case letter and its corresponding 
lower case letter are equivalent. 


Examples of valid passwords are: mar84ch, JonathOn, and BRAV3S. 
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The UNIX system you are using may have different requirements to consider 
NOTE when choosing a password. Ask your system administrator for details. 


6. For verification, the system asks you to reenter your new password. Type 
your new password again. 


f 


7. If you do not reenter the new password exactly as typed the first time, the 
system tells you the passwords do not match and asks you to try the pro- 
cedure again. On some systems, however, the communication link may 
be dropped if you do not reenter the password exactly as typed the first 
time. If this happens, you must return to step 1 and begin the login pro- 
cedure again. When the passwords match, the system displays the 
prompt. 


The following screen summarizes this procedure (steps 1 through 6) for first- 
time UNIX system users. 


login: starship <CR> 
password: <CR> 

Your password has expired. 
Choose a new one. 

Old password: <CR> 

New password: <CR> 
Re-enter new password: <CR> 
$ 
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Possible Problems when Logging In 


A terminal usually behaves predictably when you have configured it properly. 
Sometimes, however, it may act peculiarly. For example, the carriage return may 
not work properly. 


Some problems can be corrected simply by logging off the system and logging 
in again. If logging in a second time does not remedy the problem, you should 
first check the following and try logging in once again: 


the keyboard Keys labeled CAPS, LOCAL, BLOCK, and so on 
should not be enabled (put into the locked position). 
You can usually disable these keys simply by press- 


ing them. 
the data phone set If your terminal is connected to the computer 
or modem via telephone lines, verify that the baud rate and 


duplex settings are correctly specified. 


the switches Some terminals have several switches that must be 
set to be compatible with the UNIX system. If this 
is the case with the terminal you are using, make 
sure they are set properly. 


Refer to the section "Required Terminal Settings" in this chapter if you need 
information to verify the terminal configuration. If you need additional informa- 
tion about the keyboard, terminal, data phone, or modem, check the owner’s 
manuals for the appropriate equipment. 


Figure 2-5 presents a list of procedures you can follow to detect, diagnose, 
and correct some problems you may experience when logging in. If you need fur- 
ther help, contact your system administrator. 
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Problem+ 


Meaningless characters 


Input/output appears in 
UPPER CASE letters 


Input appears in UPPER 
CASE, output in lower case 


Input is printed twice 


Tab key does not work prop- 
erly 


Communication link cannot be 
established although high 
pitched tone is heard when 
dialing in 

Communication link (terminal 
to UNIX system) is repeatedly 
dropped 


Possible Cause 


UNIX system at wrong speed 


Terminal configuration includes 
UPPER CASE setting 


Key labeled CAPS (or CAPS 
LOCK) is enabled 


Terminal is set to HALF 
DUPLEX mode 


Tabs are not set correctly 


Terminal is set to LOCAL or 
OFF-LINE mode 


Bad telephone line or bad com- 
munications port 


Action/Remedy 


Press RETURN or BREAK key 


Log off and set character gen- 
eration to lower case 


Press CAPS or CAPS LOCK 
key to disable setting 


Change setting to FULL 
DUPLEX mode 


Type stty —tabst 


Set terminal to ON-LINE mode 


try logging in again 


Call system administrator 


Numerous problems can occur if your terminal is not configured properly. To eliminate these 
possibilities before attempting to log in, perform the configuration checks listed under 


"Required Terminal Settings." 


Some problems may be specific to your terminal, data phone set, or modem. Check the 
owner’s manual for the appropriate equipment if suggested actions do not remedy the problem. 


Typing stty —tabs corrects the tab setting only for your current computing session. To ensure 
a correct tab setting for all sessions, add the line stty —tabs to your .profile (see Chapter 7). 


Figure 2-5: Troubleshooting Problems When Logging In* 
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Simple Commands 


When the prompt appears on your screen, the UNIX system has recognized 
you as an authorized user and is waiting for you to request a program by entering 
a command. 


For example, try running the date command. After the prompt, type the 
command and press the RETURN key. The UNIX system accesses a program 
called date, executes it, and prints its results on the screen, as shown below. 


$ date<CR> 
Wed Oct 15 09:49:44 EDT 1986 
$ 


As you can see, the date command prints the date and time, using the 24-hour 
Clock. 


Now type the who command and press the RETURN key. Your screen will 
look something like this: 
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$ who<CR> 


acct123 
jmrs 
$ 


The who command lists the login names of everyone currently working on your 
system. The tty designations refer to the special files that correspond to each 
user’s terminal. The date and time at which each user logged in are also shown. 


The help Command 


To help you learn how to use these and other commands, the UNIX system 
provides an on-line teaching aid: the help command. This program tells you 
which command you need to perform a particular task and how to execute specific 
commands. For novice users of the UNIX system, it also provides definitions of 
vocabulary and explanations of basic concepts about the system. 


The help command is not available on all UNIX systems; check with your sys- 
NOTE tem administrator to find out if it is installed on your system. 


When you need assistance, type help and press the RETURN key. The pro- 
gram gives you a choice of four ways in which it can help you: by providing gen- 
eral information; by locating the appropriate command for a particular task; by 
giving you instructions on how to use a particular command; and by defining 
terms. The following example shows how this menu appears on your screen when 
you type the command. 
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$ help<CR> 
help: UNIX System On-Line Help 


choices description 
starter: general information 
locate: find a command with keywords 
usage: information about commands 


glossary: definitions of terms 


Redirect to a file or a command 
Quit 


Enter choice > 7 


Each choice on this menu (starter, locate, usage, and glossary) is an interac- 
tive menu program. Request one of these programs by typing the option listed 
beside it under choices (such as wu). 


Because starter, locate, usage, and glossary are programs, they can also be 
called from the shell. Once you are familiar with them, you can skip the step of 
entering the help command first. If you know which program you want to run, 
you can call it by typing its name as either a command or an argument to the 
help command. For example, to call the usage program, use one of the following 
command lines: 


help usage <CR> 
or 


usage <CR> 


BASICS FOR UNIX SYSTEM USERS 37 


Establishing Contact with the UNIX System 


The program you choose responds by printing a summary of its function, a 
menu of choices, instructions, and examples of how to follow the instructions. In 
this way, the help program leads you through a series of steps that enable you to 
get the information you need. 


Logging Off 


When you have completed a session with the UNIX system, type <“d> after 
the prompt. (Remember that control characters such as <“d> are typed by 
holding down the control key and pressing the appropriate alphabetic key. 
Because they are nonprinting characters, they do not appear on your screen.) 
After several seconds, the UNIX system will display the login: prompt again. 


$ <“d> 

login: 
This shows that you have logged off successfully and the system is ready for 
someone else to log in. 


nal or hang up the telephone. If you do not, you may not be actually logged off 


pom Always log off the UNIX system by typing <“d> before you turn off the termi- 
NOTE 
the system. 


The exit command also allows you to log off but is not used by most users. It 
may be convenient if you want to include a command to log off within a shell pro- 
gram. (For details, see the "Special Commands" section of the sh(1) page in the 
User’s Reference Manual.) 
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Introduction 


To use the UNIX file system effectively you must be familiar with its struc- 
ture, know something about your relationship to this structure, and understand 
how the relationship changes as you move around within it. This chapter prepares 
you to use this file system. 


The first two sections ("How the File System is Structured" and "Your Place 
in the File System") offer a working perspective of the file system. The rest of the 
chapter introduces UNIX system commands that allow you to build your own 
directory structure, access and manipulate the subdirectories and files you organ- 
ize within it, and examine the contents of other directories in the system for which 
you have access permission. 


Each command is discussed in a separate subsection. Tables at the end of 
these subsections summarize the features of each command so that you can later 
review a command’s syntax and capabilities quickly. Many of the commands 
presented in this section have additional, sophisticated uses. These, however, are 
left for more experienced users and are described in other UNIX system docu- 
mentation. All the commands presented here are basic to using the file system 
efficiently and easily. Try using each command as you read about it. 
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The file system is comprised of a set of ordinary files, special files, and direc- 
tories. These components provide a way to organize, retrieve, and manage infor- 
mation electronically. Chapter 1 introduced the properties of directories and files; 
this section will review them briefly before discussing how to use them. 


@ An ordinary file is a collection of characters stored on a disk. It may con- 
tain text for a report or code for a program. 


= A special file represents a physical device, such as a terminal or disk. 


m A directory is a collection of files and other directories (sometimes called 
subdirectories). Use directories to group files together on the basis of any 
criteria you choose. For example, you might create a directory for each 
product that your company sells or for each of your student’s records. 


The set of all the directories and files is organized into a tree shaped struc- 
ture. Figure 3-1 shows a sample file structure with a directory called root (/) as 
its source. By moving down the branches extending from root, you can reach 
several other major system directories. By branching down from these, you can, 
in turn, reach all the directories and files in the file system. 


In this hierarchy, files and directories that are subordinate to a directory have 
what is called a parent/child relationship. This type of relationship is possible for 
many layers of files and directories. In fact, there is no limit to the number of 
files and directories you may create in any directory that you own. Neither is 
there a limit to the number of layers of directories that you may create. Thus you 
have the capability to organize your files in a variety of ways, as shown in Figure 
3-1. 
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at Pie oS 
LIS WV OO 


C) = Directories 
[ | = Ordinary Files 
Aes = Special Files 


Figure 3-1: A Sample File System 
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Whenever you interact with the UNIX system, you do so from a location in 
its file system structure. The UNIX system automatically places you at a specific 
point in its file system every time you log in. From that point, you can move 
through the hierarchy to work in any of your directories and files and to access 
those belonging to others that you have permission to use. 


The following sections describe your position in the file system structure and 
how this position changes as you move through the file system. 


Your Home Directory 


When you successfully complete the login procedure, the UNIX system places 
you at a specific point in its file system structure called your login or home direc- © 
tory. The login name assigned to you when your UNIX system account was set 
up is usually the name of this home directory. Every user with an authorized 
login name has a unique home directory in the file system. 


The UNIX system is able to keep track of all these home directories by main- 
taining one or more system directories that organize them. For example, the 
home directories of the login names starship, mary2, and jmrs are contained in a 
system directory called userl. Figure 3-2 shows the position of a system directory 
such as user! in relation to the other important UNIX system directories dis- 
cussed in Chapter 1. 
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Figure 3-2: Directory of Home Directories 
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Within your home directory, you can create files and additional directories 
(sometimes called subdirectories) in which to group them. You can move and 
delete your files and directories, and you can control access to them. You have 
full responsibility for everything you create in your home directory because you © 
own it. Your home directory is a vantage point from which to view all the files 
and directories it holds, and the rest of the file system, all the way up to root. 


Your Current Directory 


As long as you continue to work in your home directory, it is considered your 
current working directory. If you move to another directory, that directory 
becomes your new current directory. 


The UNIX system command pwd (short for print working directory) prints 
the name of the directory in which you are now working. For example, if your 
login name is starship and you execute the pwd command in response to the first 
prompt after logging in, the UNIX system will respond as follows: 


$ pwd<CR> 
/aser 1/starship 
$ 


The system response gives you both the name of the directory in which you 
are working (starship) and the location of that directory in the file system. The 
path name /user1/starship tells you that the root directory (shown by the lead- 
ing / in the line) contains the directory userl which, in turn, contains the direc- 
tory starship. (AII other slashes in the path name other than root are used to 
separate the names of directories and files, and to show the position of each direc- 
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tory relative to root.) A directory name that shows the directory’s location in this 
way is Called a full or complete directory name or path name. In the next few 
pages we will analyze and trace this path name so you can start to move around 
in the file system. 


Remember, you can determine your position in the file system at any time 
simply by issuing a pwd command. This is especially helpful if you want to read 
or copy a file and the UNIX system tells you the file you are trying to access does 
not exist. You may be surprised to find you are in a different directory than you 
thought. 


Figure 3-3 provides a summary of the syntax and capabilities of the pwd com- 
mand. 


Command Recap 


pwd — print full name of working directory 
options arguments 


none none 


Description: pwd prints the full path name of the directory in which 
you are currently working. 


Figure 3-3: Summary of the pwd Command 


Path Names 


Every file and directory in the UNIX system is identified by a unique path 
name. The path name shows the location of the file or directory, and provides 
directions for reaching it. Knowing how to follow the directions given by a path 
name is your key to moving around the file system successfully. The first step in 
learning about these directions is to learn about the two types of path names: full 
and relative. 
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Full Path Names 


A full path name (sometimes called an absolute path name) gives directions 
that start in the root directory and lead you down through a unique sequence of 
directories to a particular directory or file. You can use a full path name to reach 
any file or directory in the UNIX system in which you are working. 


Because a full path name always starts at the root of the file system, its lead- 
ing character is always a / (slash). The final name in a full path name can be 
either a file name or a directory name. All other names in the path must be 
directories. 


To understand how a full path name is constructed and how it directs you, 
consider the following example. Suppose you are working in the starship direc- 
tory, located in /user1. You issue the pwd command and the system responds by 
printing the full path name of your working directory: /user1/starship. 
Analyze the elements of this path name using the following diagram and key. 
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system 
directory home 
root directory 
delimiter 
user 1/starship 


/ (leading) 


the slash that appears as the first character in the path name ts 
the root of the file system 


user 1 = system directory one level below root in the hierarchy to which 
root points or branches 


/ (subsequent) = the next slash separates or delimits the directory names user] 
and starship 


starship current working directory 


Now follow the bold lines in Figure 3-4 to trace the full path to /userl/starship. 
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Figure 3-4: Full Path Name of the /userl/starship Directory 
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Relative Path Names 


A relative path name gives directions that start in your current working direc- 
tory, and lead you up or down through a series of directories to a particular file or 
directory. By moving down from your current directory, you can access files and 
directories you own. By moving up from your current directory, you pass through 
layers of parent directories to the grandparent of all system directories, root. 
From there you can move anywhere in the file system. 


A relative path name begins with one of the following: a directory or file 
name; a. (pronounced dot), which is a shorthand notation for your current direc- 
tory; or a .. (pronounced dot dot), which is a shorthand notation for the directory 
immediately above your current directory in the file system hierarchy. The direc- 
tory represented by .. (dot dot) is called the parent directory of . (your current 
directory). 

For example, say you are in the directory starship in the sample system and 
starship contains directories named draft, letters, and bin and a file named mbox. 
The relative path name to any of these is simply its name, such as draft or mbox. 
Figure 3-5 traces the relative path from starship to draft. 
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Figure 3-5: Relative Path Name of the draft Directory 


The draft directory belonging to starship contains the files outline and table. 
The relative path name from starship to the file outline is draft/outline: 


Figure 3-6 traces this relative path. Notice that the slash in this path name 
separates the directory named draft from the file named outline. Here, the slash 
is a delimiter showing that outline is subordinate to draft; that is, outline is a child 
of its parent, draft. 
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Figure 3-6: Relative Path Name from starship to outline 


So far, the discussion of relative path names has covered how to specify 
names of files and directories that belong to, or are children of, your current 
directory. You now know how to move down the system hierarchy level by level 
until you reach your destination. You can also, however, ascend the levels in the 
system structure or ascend and subsequently descend into other files and direc- 
tories. 


To ascend to the parent of your current directory, you can use the .. notation. 
This means that if you are in the directory named draft in the sample file system, 
.. is the path name to starship, and ../.. is the path name to starship’s parent 
directory, user1. 
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From draft, you can also trace a path to the file sanders by using the path 
name ../letters/sanders. The .. brings you up to starship. Then the names letters 
and sanders take you down through the letters directory to the sanders file. 


Keep in mind that you can always use a full path name in place of a relative 
one. 


Figure 3-7 shows some examples of full and relative path names. 


Path Name Meaning 


/ full path name of the root directory 


/bin full path name of the bin directory (contains most 
executable programs and utilities) 


/user1/starship/bin/tools full path name of the tools directory belonging to 
the bin directory that belongs to the starship 
directory belonging to user] that belongs to root 


bin/tools relative path name to the file or directory tools in 
the directory bin 


If the current directory is /, then the UNIX sys- 
tem searches for /bin/tools. However, if the 
current directory is starship, then the system 
searches the full path /user1/starship/bin/tools. 


relative path name of a file or directory tools in 
the current directory. 


Figure 3-7: Example Path Names 
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You may need some practice before you can use path names such as these to 
move around the file system with confidence. However, this is to be expected 
when learning a new concept. 


Naming Directories and Files 


You can give your directories and files any names you want, as long as you 
observe the following rules: 


The name of a directory (or file) can be from one to fourteen characters 
long. 


All characters other than / are legal. 
Some characters are best avoided, such as a space, tab, backspace, and the 
following: 

?@#$*7&* (CV TI\ | 3 ’"< > 
If you use a blank or tab in a directory or file name, you must enclose the 
name in quotation marks on the command line. 
Avoid using a +, — or. as the first character in a file name. 


Upper case and lower case characters are distinct to the UNIX system. 
For example, the system considers a directory (or file) named draft to be 
different from one named DRAFT. 


The following are examples of legal directory or file names: 


memo MEMO section2 ref:list 
file.d chap3 +4 item1-10 outline 


The rest of this chapter introduces UNIX system commands that enable you 
to examine the file system. 
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This section introduces four UNIX system commands that enable you to 
organize and use a directory structure: mkdir, Is, cd, and rmdir. 


mkdir enables you to make new directories and subdirectories 
within your current directory 

Is lists the names of all the subdirectories and files in a 
directory 

cd enables you to change your location in the file system 


from one directory to another 


rmdir enables you to remove an empty directory 


These commands can be used with either full or relative path names. Two of 
the commands, Is and cd, can also be used without a path name. Each command 
is described more fully in the four sections that follow. 


Creating Directories: the mkdir Command 


It is recommended that you create subdirectories in your home directory 
according to a logical and meaningful scheme that will facilitate the retrieval of 
information from your files. If you put all files pertaining to one subject together 
in a directory, you will know where to find them later. 


To create a directory, use the command mkdir (short for make directory). 
Simply enter the command name, followed by the name you are giving your new 
directory or file. For example, in the sample file system, the owner of the draft 
subdirectory created draft by issuing the following command from the home direc- 
tory (/user1/starship): 


$ mkdir draft <CR> 
$ 


The second prompt shows that the command has succeeded; the subdirectory draft 
has been created. 


Still in the home directory, this user created other subdirectories, such as 
letters and bin, in the same way. 
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$ mkdir letters<CR> 
$ mkdir bin<CR> 
$ 


The user could have created all three subdirectories (draft, letters, and bin) simul- 
taneously by listing them all on a single command line. 


$ mkdir draft letters bn<CR> 
$ 


You can also move to a subdirectory you created and build additional sub- 
directories within it. When you build directories or create files, you can name 
them anything you want as long as you follow the guidelines listed earlier under 
"Naming Directories and Files." 


Figure 3-8 summarizes the syntax and capabilities of the mkdir command. 


Command Recap 


mkdir — make a new directory 
command options arguments 
mkdir none directoryname(s) 


Description: mkdir creates a new directory (subdirectory). 


Remarks: The system returns a prompt ($ by default) if the 
directory is successfully created. 


Figure 3-8: Summary of the mkdir Command 


USING THE FILE SYSTEM 55 


Organizing a Directory 


Listing the Contents of a Directory: the ls Command 


All directories in the file system have information about the files and direc- 
tories they contain, such as name, size, and the date last modified. You can 
obtain this information about the contents of your current directory and other sys- 
tem directories by executing the command Is (short for list). 


The Is command lists the names of all files and subdirectories in a specified 
directory. If you do not specify a directory, Is lists the names of files and direc- 
tories in your current directory. To understand how the Is command works, con- 
sider the sample file system (Figure 3-2) once again. 


Say you are logged in to the UNIX system and you run the pwd command. 
The system responds with the path name /user1/starship. To display the names of 
files and directories in this current directory, you then type Is and press the 
RETURN key. After this sequence, your terminal will read: 


$ pwd<CR> 
$/user 1/starship 
$ Ils<CR> 

bin 

draft 


letters 
list 
mbox. 

$ 


As you can see, the system responds by listing, in alphabetical order, the 
names of files and directories in the current directory starship. (If the first char- 
acter of any of the file or directory names had been a number or an upper case 
letter, it would have been printed first.) 
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To print the names of files and subdirectories in a directory other than your 
current directory without moving from your current directory, you must specify 
the name of that directory as follows: 


Is pathname <CR> 


The directory name can be either the full or relative path name of the desired 
directory. For example, you can list the contents of draft while you are working 
in starship by entering Is draft and pressing the RETURN key. Your screen will 
look like this: 


$ Is draft<CR> 
outline 
table 


$ 


Here, draft is a relative path name from a parent (starship) to a child (draft) 
directory. 


You can also use a relative path name to print the contents of a parent direc- 
tory when you are located in a child directory. The .. (dot dot) notation provides 
an easy way to do this. For example, the following command line specifies the 
relative path name from starship to user1: 
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$ Is .<CR> 


You can get the same results by using the full path name from root to userl. If 
you type Is /userl and press the RETURN key, the system will respond by print- 
ing the same list. 


Similarly, you can list the contents of any system directory that you have per- 
mission to access by executing the Is command with a full or relative path name. 


The Is command is useful if you have a long list of files and you are trying to 
determine whether one of them exists in your current directory. For example, if 
you are in the directory draft and you want to determine if the files named outline 
and notes are there, use the Is command as follows: 


$ Is outline notes<CR> 
outline 
notes not found 


$ 


The system acknowledges the existence of outline by printing its name, and says 
that the file notes is not found. | 
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The ls command does not print the contents of a file. If you want to see what 
a file contains, use the cat, pg, or pr command. These commands are described in 
"Accessing and Manipulating Files," later in this chapter. 


Frequently Used Is Options 


The Is command also accepts options that cause specific attributes of a file or 
subdirectory to be listed. There are more than a dozen available options for the Is 
commands. Of these, the —a and —1 will probably be most valuable in your 
basic use of the UNIX system. Refer to the Is(1) page in the User’s Reference 
Manual for details about other options. 


Listing All Names in a File 


Some important file names in your home directory, such as .profile (pro- 
nounced dot-profile), begin with a period. (As you can see from this example, 
when a period is used as the first character of a file name it is pronounced dot.) 
When a file name begins with a dot, it is not included in the list of files reported 
by the ls command. If you want the Is to include these files, use the —a option on 
the command line. 


For example, to list all the files in your current directory (starship), including 
those that begin with a . (dot), type Is —a and press the RETURN key. 


$ Ils —a<CR> 


-profile 
bin 
draft 
letters 
list 
mbox 

$ 
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Listing Contents in Short Format 


The —C and —F options for the ls command are frequently used. Together, 
these options list a directory’s subdirectories and files in columns, and identify 
executable files (with an *) and directories (with a /). Thus, you can list all files 
in your working directory starship by executing the command line shown here: 


$ Ils -CF<CR> 


letters/ 
list* 


Listing Contents in Long Format 


Probably the most informative Is option is —l, which displays the contents of a 
directory in long format, giving mode, number of links, owner, group, size in 
bytes, and time of last modification for each file. For example, say you run the Is 
—l command while in the starship directory. 


$ Is —1<CR> 


3 starship bin 
2 starship draft 


2 starship letters 
2 starship list 
1 starship mbox 
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The first line of output (total 30) shows the amount of disk space used, mea- 
sured in blocks. Each of the rest of the lines comprises a report on a directory or 
file in starship. The first character in each line (a, —, b, or c) tells you the type 
of file. 


ad = directory 
— =. ordinary disk file 
b = _ block special file 


c = character special file 


Using this key to interpret the previous screen, you can see that the starship direc- 
tory contains three directories and two ordinary disk files. 


The next several characters, which are either letters or hyphens, identify who 
has permission to read and use the file or directory. (Permissions are discussed in 
the description of the chmod command under "Accessing and Manipulating Files" 
later in this chapter.) 


The following number is the link count. For a file, this equals the number of 
users linked to that file. For a directory, this number shows the number of direc- 
tories immediately under it plus two (for the directory itself and its parent direc- 
tory). 


Next, the login name of the file’s owner appears (here it is starship), followed 
by the group name of the file or directory (project). 


The following number shows the length of the file or directory entry measured 
in units of information (or memory) called bytes. The month, day, and time that 
the file was last modified is given next. Finally, the last column shows the name 
of the directory or file. 


Figure 3-9 identifies each column in the rows of output from the 
Is —1 command. 
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number of owner 
blocks used name 
number group 
of links name name 


! 


total 30 
rwxr-xr-x 3 starship project 96 Oct 27 08:16 bin 
File rwxr-xr-x 2 starship project 64 Nov 1 14:19 draft 
type ~~ \d| rwxr-xr-x 2 starship project 80 Nov 8 08:41 letters 
I'WX------ 2 starship project 12301 Nov 2 10:15 list 
IW------- 1 starship project 40 Oct 27 10:00 mbox 


ae ae 


time/date last 
permissions modified 


Figure 3-9: Description of Output Produced by the Is —1 Command 


Figure 3-10 summarizes the syntax and capabilities of the Is command and 
two available options. 
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Command Recap 


Is — list contents of a directory 
command options arguments 
Is —a, —l, and others* directoryname(s) 


Description: Is lists the names of the files and subdirectories in the 
specified directories. If no directory name is given as 
an argument, the contents of your working directory 
are listed. 


Options: —a_ Lists all entries, including those beginning 


with . (dot). 


—I Lists contents of a directory in long format 
furnishing mode, permissions, size in bytes, 
and time of last modification. 


Remarks: | If you want to read the contents of a file, use the cat 
command. 


- See the Is(1) page in the User’s Reference Manual for all available options and an explanation 


of their capabilities. 


Figure 3-10: Summary of the Is Command 
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Changing Your Current Directory: the cd Command 


When you first log in on the UNIX system, you are placed in your home 
directory. As long as you do work in it, it is also your current working directory. 
However, by using the command cd (short for change directory), you can work in 
other directories as well. To use this command, enter cd, followed by a path 
name to the directory to which you want to move. 


ed pathname_of_newdirectory<CR> 


Any valid path name (full or relative) can be used as an argument to the cd com- 
mand. If you do not specify a path name, the command will move you to your 
home directory. Once you have moved to a new directory, it becomes your 
current directory. 


For example, to move from the starship directory to its child directory draft 
(in the sample file system), type cd draft and press the RETURN key. (Here 
draft is the relative path name to the desired directory.) When you get a prompt, 
verify your new location by typing pwd and pressing the RETURN key. Your 
terminal screen will look like this: 


$ cd draft<CR> 
$ pwd<CR> 
/user 1/starship/draft 


$ 


Now that you are in the draft directory you can create subdirectories in it by 
using the mkdir command, and new files, by using the ed and vi editors. (See 
Chapters 5 and 6 for tutorials on the ed and vi commands, respectively.) 
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It is not necessary to be in the draft directory to access files within it. You 
can access a file in any directory by specifying a full path name for it. For exam- 
ple, to cat the sanders file in the letters directory (/user1/starship/letters) while 
you are in the draft directory (/user1/starship/draft), specify the full path name 
of sanders on the command line. 


cat /user1/starship/letters/sanders <CR> 
You may also use full path names with the cd command. For example, to 


move to the letters directory from the draft directory, specify 
/user1/starship/letters on the command line, as follows: 


cd /user1/starship/letters <CR> 
Also, because letters and draft are both children of starship, you can use the 


relative path name ../letters with the cd command. The .. notation moves you 
to the directory starship, and the rest of the path name moves you to letters. 


Figure 3-11 summarizes the syntax and capabilities of the ed command. 
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Command Recap 


cd — change your working directory 
command options arguments 
cd none directoryname 


Description: cd changes your position in the file system from the 
current directory to the directory specified. If no 
directory name is given as an argument, the cd com- 
mand places you in your home directory. 


Remarks: When the shell places you in the directory specified, 
the prompt ($ by default) is returned to you. To 
access a directory that is not in your working directory, 
you must use the full or relative path name in place of 
a simple directory name. 


Figure 3-11: Summary of the cd Command 


Removing Directories: the rmdir Command 
If you no longer need a directory, you can remove it with the command rmdir 
(short for remove a directory). The standard syntax for this command is: 
rmdir directoryname(s)<CR> 
You can specify more than one directory name on the command line. 


The rmdir command will not remove a directory if you are not the owner of it 
or if the directory is not empty. If you want to remove a file in another user’s 
directory, the owner must give you write permission for the parent directory of the 
file you want to remove. 
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If you try to remove a directory that still contains subdirectories and files 
(that is, is not empty), the rmdir command prints the message directoryname not 
empty. You must remove all subdirectories and files; only then will the command 
succeed. 


For example, say you have a directory called memos that contains one sub- 
directory, tech, and two files, june.30 and july.31. (Create this directory in your 
home directory now so you can see how the rmdir command works.) If you try to 
remove the directory memos (by issuing the rmdir command from your home 
directory), the command responds as follows: 


$ rmdir memos<CR> 
rmdir: memos not empty 
$ 


To remove the directory memos, you must first remove its contents: the subdirec- 
tory tech, and the files june.30 and july.31. You can remove the tech subdirectory 
by executing the rmdir command. For instructions on removing files, see "Access- 
ing and Manipulating Files" later in this chapter. 


Once you have removed the contents of the memos directory, memos itself can 
be removed. First, however, you must move to its parent directory (your home 
directory). The rmdir command will not work if you are still in the directory you 
want to remove. From your home directory, type: 


rmdir memos <CR> 
If memos is empty, the command will remove it and return a prompt. 


Figure 3-12 summarizes the syntax and capabilities of the rmdir command. 
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command 


rmdir 


Description: 


Remarks: 


Command Recap 


rmdir — remove a directory 


options arguments 


none directoryname(s) 


rmdir removes specified directories if they do not con- 
tain files and/or subdirectories. 


If the directory is empty, it is removed and the sys- 
tem returns a prompt. If the directory contains files 
or subdirectories, the command returns the message, 
rmdir: directoryname not empty. 


Figure 3-12: Summary of the rmdir Command 


68 USER’S GUIDE 


Accessing and Manipulating Files 


This section introduces several UNIX system commands that access and 
manipulate files in the file system structure. Information in this section is organ- 
ized into two parts; basic and advanced. The part devoted to basic commands is 
fundamental to using the file system; the advanced commands offer more sophisti- 
cated information processing techniques for working with files. 


Basic Commands 
This section discusses UNIX system commands that are necessary for access- 


ing and using the files in the directory structure. Figure 3-13 lists these com- 
mands. 
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Command Function 


prints the contents of a specified file on a 
terminal 


prints the contents of a specified file on a 
terminal in chunks or pages 


prints a partially formatted version of a 
specified file on the terminal 


makes a duplicate copy of an existing file 


reports the number of lines, words, and 
characters in a file 


changes permission modes for a file (or a 
directory) 


requests a paper copy of a file from a line 
printer 


Figure 3-13: Basic Commands for Using Files 


‘ 
| 
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Each command is discussed in detail and summarized in a table that you can 
easily reference later. These tables will allow you to review the syntax and capa- 
bilities of these commands at a glance. 


Displaying a File’s Contents: the cat, pg, and pr Commands 


The UNIX system provides three commands for displaying and printing the 
contents of a file or files: cat, pg, and pr. The cat command (short for concaten- 
ate) outputs the contents of the file(s) specified. This output is displayed on your 
terminal screen unless you tell cat to direct it to another file or a new command. 


The pg command is particularly useful when you want to read the contents of 
a long file because it displays the text of a file in pages a screenful at a time. The 
pr command formats specified files and displays them on your terminal or, if you 
so request, directs the formatted output to a printer (see the lp command in this 
chapter). 


The following sections describe how to use the cat, pg, and pr commands. 


Concatenate and Print Contents of a File: the cat Command 
The cat command displays the contents of a file or files. For example, say 
you are located in the directory letters (in the sample file system) and you want to 


display the contents of the file johnson. Type the command line shown on the 
screen and you will receive the following output: 
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$ cat johnson<CR> 
March 5, 1986 


Mr. Ron Johnson 
Layton Printing 
52 Hudson Street 
New York, N.Y. 


Dear Mr. Johnson: 


I enjoyed speaking with you this morming 
about your company’s plans to automate 
your business. 

Enclosed please find 

the material you requested 

about AB&C’s line of computers 

and office automation software. 


If I can be of further assistance to you, 
please don’t hesitate to call. 


Yours truly, 


John Howe 
$ 


To display the contents of two (or more) files, simply type the names of the 
files you want to see on the command line. For example, to display the contents 
of the files johnson and sanders, type: 


$ cat johnson sanders <CR> 


The cat command reads johnson and sanders and displays their contents in that 
order on your terminal. 
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$ cat johnson sanders <CR> 
March 5, 1986 


Mr. Ron Johnson 
Layton Printing 
52 Hudson Street 
New York, N.Y. 
Dear Mr. Johnson: 


I enjoyed speaking with you this morning 


Yours truly, 

John Howe 

March 5, 1986 

Mrs. D.L. Sanders 
Sanders Research, Inc. 
43 Nassau Street 


Princeton, N.J. 


Dear Mrs. Sanders: 


My colleagues and I have been following, with great interest, 


Sincerely, 


John Howe 
$ 
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To direct the output of the cat command to another file or to a new com- 
mand, see the sections in Chapter 7 that discuss input and output redirection. 


Figure 3-14 summarizes the syntax and capabilities of the cat command. 


Command Recap 


cat — concatenate and print a file’s contents 


command options arguments 


cat available* filename (s) 


Description: The cat command reads the name of each file 
specified on the command line and displays its con- 
tents. 


Remarks: If a specified file exists and is readable, its contents 
are displayed on the terminal screen; otherwise, the 
message cat: cannot open filename appears on the 
screen. 


To display the contents of a directory, use the Is com- 
mand. 


See the cat(1) page in the User’s Reference Manual for all available options and an 
explanation of their capabilities. 


Figure 3-14: Summary of the cat Command 
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Paging Through the Contents of a File: the pg Command 


The command pg (short for page) allows you to examine the contents of a 
file or files, page by page, on a terminal. The pg command displays the text of a 
file in pages (chunks) followed by a colon prompt (:), a signal that the program is 
waiting for your instructions. Possible instructions you can then issue include 
requests for the command to continue displaying the file’s contents a page at a 
time, and a request that the command search through the file(s) to locate a 
specific character pattern. Figure 3-15 summarizes some of the available instruc- 
tions. 
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help; display list of available pg} commands 


quit pg perusal mode 

display next page of text 

display next line of text 

display additional half page of text 

redisplay current page of text 

skip next page of text and display following one 


begin displaying next file you specified 
on command line 


display previous file specified on command line 


display last page of text in file currently displayed 


/pattern search forward in file for specified character pattern 


?pattern search backward in file for specified character pat- 


tern 


Most commands can be typed with a number preceding them. For example, 
+1~(display next page), —1~ (display previous page), or 17 (display first page of 
text). 


See the User’s Reference Manual for a detailed explanation of all available pg com- 
mands. 


Figure 3-15: Summary of Commands to Use with pg 
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The pg command is useful when you want to read a long file or a series of 
files because the program pauses after displaying each page, allowing time to 
examine it. The size of the page displayed depends on the terminal. For exam- 
ple, on a terminal capable of displaying twenty-four lines, one page is defined as 
twenty-three lines of text and a line containing a colon. However, if a file is less 
than twenty-three lines long, its page size will be the number of lines in the file 
plus one (for the colon). 


To peruse the contents of a file with pg, use the following command line for- 
mat: 


pg filename(s)<CR> 
For example, to display the contents of the file outline in the sample file sys- 
tem, type: 
pg outline<CR> 


The first page of the file will appear on the screen. Because the file has more 
lines in it than can be displayed on one page, a colon appears at the bottom of the 
screen. This is a reminder to you that there is more of the file to be seen. When 
you are ready to read more, press the RETURN key and pg will print the next 
page of the file. 


The following screen summarizes our discussion of the pg command this far. 
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$ pg outline<CR> 

After you analyze the subject for your 
report, you must consider organizing and 
arranging the material you want to use in 
writing it. 


An outline is an effective method of 
organizing the material. The outline 

is a type of blueprint or skeleton, 

a framework for you the builder-writer 
of the report; in a sense it is a recipe 
:<CR> 


After you press the RETURN key, pg will resume printing the file’s contents on 
the screen. 


that contains the names of the 
ingredients and the order in which 
to use them. 


Your outline need not be elaborate or 
overly detailed; it is simply a guide you 
may consult as you write, to be varied, 

if need be, when additional important 
ideas are suggested in the actual writing. 
(EOF): 
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Notice the line at the bottom of the screen containing the string (HOF):. 
This expression (EOF) means you have reached the end of the file. The colon 
prompt is a cue for you to issue another command. 


When you have finished examining the file, press the RETURN key; a 
prompt will appear on your terminal. (Typing q or Q and pressing the RETURN 
key also gives you a prompt.) Or you can use one of the other available com- 
mands, depending on your needs. In addition, there are a number of options that 
can be specified on the pg command line (see the pg(1) page in the User’s Refer- 
ence Manual). 


Proper execution of the pg command depends on specifying the type of termi- 
nal you are using. This is because the pg program was designed to be flexible 
enough to run on many different terminals; how it is executed differs from termi- 
nal to terminal. By specifying one type, you are telling this command: 


= how many lines to print 

@ how many columns to print 

™ how to clear the screen 

™ how to highlight prompt signs or other words 

m™ how to erase the current line 

To specify a terminal type, assign the code for your terminal to the TERM 


variable in your .profile file. (For more information about TERM and .profile, see 
Chapter 7; for instructions on setting the TERM variable, see Appendix F.) 


Figure 3-16 summarizes the syntax and capabilities of the pg command. 
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Command Recap 


pg — display a file’s contents in chunks or pages 


command options arguments 


pg available* filename (s) 


Description: The pg command displays the contents of the 
specified file(s) in pages. 


Remarks: After displaying a page of text, the pg command 
awaits instructions from you to do one of the fol- 
lowing: continue to display text, search for a pat- 
tern of characters, or exit the pg perusal mode. 
In addition, a number of options are available. 
For example, you can display a section of a file 
beginning at a specific line or at a line containing 
a certain sequence or pattern. You can also opt 
to go back and review text that has already been 
displayed. 


* See the pg(1) page in the User’s Reference Manual for all available options and an 


explanation of their capabilities. 


Figure 3-16: Summary of the pg Command 
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Print Partially Formatted Contents of a File: the pr Command 


The pr command is used to prepare files for printing. It supplies titles and 
headings, paginates, and prints a file, in any of various page lengths and widths, 
on your terminal screen. 


You have the option of requesting that the command print its output on 
another device, such as a line printer (read the discussion of the lp command in 
this section). You can also direct the output of pr to a different file (see the sec- 
tions on input and output redirection in Chapter 7). 


If you choose not to specify any of the available options, the pr command pro- 
duces output in a single column that contains sixty-six lines per page and is pre- 
ceded by a short heading. The heading consists of five lines: two blank lines; a 
line containing the date, time, file name, and page number; and two more blank 
lines. The formatted file is followed by five blank lines. (Complete sets of text 
formatting tools are available on UNIX systems equipped with the Documenter’s 
Workbench Software. Check with your system administrator to see if this 
software is available to you.) | 


The pr command is often used together with the Ip command to provide a 
paper copy of text as it was entered into a file. (See the section on the Ip com- 
mand for details.) However, you can also use the pr command to format and print 
the contents of a file on your terminal. For example, to review the contents of the 
file johnson in the sample file system, type: 


pr johnson<CR> 


The following screen gives an example of output from this command. 
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$ pr johnson<CR> 


Mar 5 15:43 1986 johnson Page 1 


March 5, 1986 


Mr. Ron Johnson 
Layton Printing 
52 Hudson Street 
New York, N.Y. 


Dear Mr. Johnson: 


I enjoyed speaking with you this morning 
about your company’s plans to automate 
your business. 

Enclosed please find 

the material you requested 

about AB&C’s line of computers 

and office automation software. 


If I can be of further assistance to you, 
please don’t hesitate to call. | 


Yours truly, 


John Howe 


The ellipses after the last line in the file represent the remaining lines (all 
blank in this case) that pr formatted into the output (so that each page contains a 
total of sixty-six lines). If you are working on a video display terminal, which 
allows you to view twenty-four lines at a time, the entire sixty-six lines of the for- 
matted file will be printed rapidly without pause. This means that the first forty- 
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two lines will roll off the top of your screen, making it impossible for you to read 
them unless you have the ability to roll back a screen or two. However, if the file 
you are examining is particularly long, even this ability may not be sufficient to 
allow you to read the file. 


In such cases, type <“s> (control—s) to interrupt the flow of printing on 
your screen. When you are ready to continue, type <“q> (control—q) to resume 
printing. 


Figure 3-17 summarizes the syntax and capabilities of the pr command. 
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Command Recap 


pr — print formatted contents of a file 


command options arguments 
pr available* filename(s) 


Description: The pr command produces a formatted copy of a 
file(s) on your terminal screen unless you specify 
otherwise. It prints the text of the file(s) on 
sixty-six line pages, and places five blank lines at 
the bottom of each page and a five-line heading at 
the top of each page. The heading includes: two 
blank lines; a line containing the date, time, file 
name, and page number; and two additional blank 
lines. 


Remarks: If a specified file exists, its contents are formatted 
and displaye; if not, the message pr: can’t open 
filename is printed. 


The pr command is often used with the lp com- 
mand to produce a paper copy of a file. It can 
also be used to review a file on a video display 
terminal. To stop and restart the printing of a file 
on a terminal, type <“s> and <“q>, respec- 
tively. 


* See the pr(1) page in the User’s Reference Manual for all available options and an 


explanation of their capabilities. 


Figure 3-17: Summary of the pr Command 
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Requesting a Paper Copy of a File: the lp Command 


Some terminals have built-in printers that allow you to get paper copies of 
files. If you have such a terminal, you can get a paper copy of your file simply by 
turning on the printer and executing the cat or pr command. However, if you are 
using a video display terminal, you must send a request for a paper copy of a file 
to a printer (see Figure 3-18). The command Ip (short for line printer) allows 
you to do this. 


With Tractor 
Feed 


With High-Speed 


With Tractor Tractor Feed 


Feed Belt 


Figure 3-18: Examples of Teletype Model 40 Line Printers 


To execute Ip, follow this format: 
Ip filename<CR> 


For example, to print the file johnson on a line printer, type the following com- 
mand line: 
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Ip johnson<CR> 


The system responds with the name (or type) of the printer on which the file will 
be printed, and an identification (ID) number for your request. 


$ Ip johnson<CR> 
request id is laser-6885 (1 file) 
$ 


The system response shows that your job is to be printed on a laser printer 
(this system’s default type of printer), has a request ID number of 6885, and 
includes one file. 


The —ddest (short for destination) option on the command line causes your 
file to be printed on another available device that you specify in the dest argu- 
ment. The —m option causes mail to be sent to you stating the job has been 
completed. 


To cancel a request to a printer, type the command cancel and specify the 
request ID number. For example, to cancel your request for a printing of the file 
letters (request ID laser-6885), type: 


cancel laser-6885 <CR> 


To check the status of a line printer job that it is in progress, or to get its 
request ID number, execute the Ipstat command. This command also provides a 
complete listing of every printer available on your system. Which printers are 
available to you depends on your UNIX system facility. Ask your system 
administrator for the names of available line printers, or type the following com- 
mand line: 


Ipstat —v<CR> 


Figure 3-19 summarizes the syntax and capabilities of the lp command. 
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Command Recap 


Ip — request paper copy of file from a line printer 
command options arguments 
Ip —d, —m, and others* file(s) 


Description: The lp command requests that specified files be 
printed by a line printer, thus providing paper 
copies of the contents. 


Options: 


—ddest Allows you to choose dest as the printer 
or type of printer to produce the paper 
copy. If you do not use this option, the 


Ip program specifies the printer for you. 


Sends a message to you via mail after 
the printing is complete. 


Remarks: You can cancel a request to the line printer by 
typing cancel and the request ID furnished to you 
by the system when the request was ack- 
nowledged. 


Check with your system administrator for infor- 
mation on additional and/or different commands 
for printers that may be available at your loca- 
tion. 


* See the Ip(1) page in the User’s Reference Manual for all available options and an 
explanation of their capabilities. 


Figure 3-19: Summary of the Ip Command 
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Making a Duplicate Copy of a File: the cp Command 


When using the UNIX system, you may want to make a copy of a file. For 
example, you might want to revise a file while leaving the original version intact. 
The command cp (short for copy) copies the complete contents of one file into 
another. The cp command also allows you to copy one or more files from one 
directory into another while leaving the original file or files in place. 


To copy the file named outline to a file named new.outline in the sample direc- 
tory, simply type cp outline new.outline and press the RETURN key. The sys-_ 
tem returns the prompt when the copy is made. To verify the existence of the 
new file, you can type Is and press the RETURN key. This command lists the 
names of all files and directories in the current directory, in this case draft. The 
following screen summarizes these activities. 


$ cp outline new.outline<CR> 
$ Is<CR> 
new.outline 


outline 
table 
$ 


The UNIX system does not allow you to have two files with the same name in 
a directory. In this case, because there was no file called new.outline when the cp 
command was issued, the system created a new file with that name. However, if 
a file called new.outline had already existed, it would have been replaced by a 
copy of the file outline; the previous version of new.outline would have been 
deleted. 


If you had tried to copy the file outline to another file named outline in the 
same directory, the system would have told you the file names were identical and 
returned the prompt to you. If you had then listed the contents of the directory to 
determine exactly how many copies of outline existed, you would have received the 
following output on your screen: 
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$ cp outline outline<CR> 
cp: outline and outline are identical 
$ Is<CR> 


outline 
table 
$ 


The UNIX system does allow you to have two files with the same name as 
long as they are in different directories. For example, the system would let you 
copy the file outline from the draft directory to another file named outline in the 
letters directory. If you were in the draft directory, you could use any one of four 
command lines. In the first two command lines, you specify the name of the new 
file you are creating by making a copy. 


= cp outline /user1/starship/letters/outline<CR> (full path name specified) 

= cp outline ../letters/outline<CR> (relative path name specified) 

However, the cp command does not require that you specify the name of the 
new file. If you do not include a name for it on the command line, ep gives your 


new file the same name as the original one, by default. Therefore you could also 
use either of these command lines: 


= cp outline /user1/starship/letters<CR> (full path name specified) 

= cp outline ../letters<CR> (relative path name specified) 

In any of these four cases, cp will make a copy of the outline file in the letters 
directory and call it outline, too. 


Of course, if you want to give your new file a different name, you must 
specify it. For example, to copy the file outline in the draft directory to a file 
named outline.vers2 in the letters directory, you can use either of the following 
command lines: 
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= cp outline /user1/starship/letters/outline.vers2<CR> (full path name) 


= cp outline ../letters/outline.vers2<CR> (relative path name) 


When assigning new names, keep in mind the conventions for naming directories 
and files described in "Naming Directories and Files" in this chapter. 


Figure 3-20 summarizes the syntax and capabilities of the ep command. 


Command Recap 


cp — make a copy of a file 


command options arguments 


filel file2 
file(s) directory 


Description: cp allows you to make a copy of filel and call it 
file2 leaving filel intact or to copy one or more 
files into a different directory. 


Remarks: When you are copying filel to file2 and a file 
called file2 already exists, the cp command 
overwrites the first version of file2 with a copy of 
filel and calls it file2. The first version of file2 is 
deleted. 


You cannot copy directories with the cp com- 
mand. 


Figure 3-20: Summary of the ep Command 
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Moving and Renaming a File: the mv Command 


The command mv (short for move) allows you to rename a file in the same 
directory or to move a file from one directory to another. If you move a file to a 
different directory, the file can be renamed or it can retain its original name. 


To rename a file within one directory, follow this format: 


mv filel file2<CR> 


The mv command changes a file’s name from file] to file2 and deletes filel. 
Remember that the names file! and file2 can be any valid names, including path 
names. 


For example, if you are in the directory draft in the sample file system 
and you would like to rename the file table to new.table, simply type 
my table new.table and press the RETURN key. If the command executes suc- 
cessfully, you will receive a prompt. To verify that the file new.table exists, you 
can list the contents of the directory by typing Is and pressing the RETURN key. 
The screen shows your input and the system’s output as follows: 


$ mv table new.table<CR> 
$ Is<CR> 
new. table 


outline 
$ 


You can also move a file from one directory to another, keeping the same 
name or changing it to a different one. To move the file without changing its 
name, use the following command line: 


my file(s) directory<CR> 


The file and directory names can be any valid names, including path names. 


USING THE FILE SYSTEM 91 


Accessing and Manipulating Files 


For example, say you want to move the file table from the current directory 
named draft (whose full path name is /user1/starship/draft) to a file with the 
same name in the directory letters (whose relative path name from draft is 
../letters and whose full path name is /user1/starship/letters), you can use any 
one of several command lines, including the following: 


mv table /user1 /starship/letters<CR> 

my table /user1 /starship/letters/table<CR> 

my table ../letters<CR> 

my table ../letters/table<CR> 

my /user1/starship/draft/table /user1/starship/letters/table<CR> 


Now suppose you want to rename the file table as table2 when moving it to 
the directory letters. Use any of these command lines: 


my table /user1/starship/letters/table2 <CR> 
mv table ../letters/table2<CR> 


mv /user1/starship/draft/table2 /user1/starship/letters/table2<CR> 
You can verify that the command worked by using the Ils command to list the 


contents of the directory. 


Figure 3-21 summarizes the syntax and capabilities of the mv command. 
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Command Recap 


mv — move or rename files 


command options arguments 


filel file2 
file(s) directory 


Description: my allows you to change the name of a file or to 
move a file(s) into another directory. 


Remarks: When you are moving file! to file2, if a file called 
file2 already exists, the mv command overwrites 
the first version of file2 with filel and renames it 
file2. The first version of file2 is deleted. 


Figure 3-21: Summary of the my Command 


Removing a File: the rm Command 


When you no longer need a file, you can remove it from your directory by 
executing the command rm (short for remove). The basic format for this com- 
mand is: 


rm file(s)<CR> 
You can remove more than one file at a time by specifying those files you 
want to delete on the command line with a space separating each filename: 
rm filel file2 file3<CR> 


The system does not save a copy of a file it removes; once you have executed this 
command, your file is removed permanently. 
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After you have issued the rm command, you can verify its successful execu- 
tion by running the Is command. Since Is lists the files in your directory, you'll 
immediately be able to see whether or not rm has executed successfully. 


For example, say you have a directory that contains two files, outline and 
table. You can remove both files by issuing the rm command once. If rm is exe- 
cuted successfully, your directory will be empty. Verify this by running the Is 
command. 


$ rm outline table <CR> 
$ Is 
$ 


The prompt shows that outline and table were removed. 


Figure 3-22 summarizes the syntax and capabilities of the rm command. 


Command Recap 


rm — remove a file 


command options arguments 


available* file(s) 


Description: rm allows you to remove one or more files. 


Remarks: Files specified as arguments to the rm command 
are removed permanently. 


* See the rm(1) page in the User’s Reference Manual for all available options and an 


explanation of their capabilities. 


Figure 3-22: Summary of the rm Command 
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Counting Lines, Words, and Characters in a File: the wc Command 


The command we (short for word count) reports the number of lines, words, 
and characters there are in the file(s) named on the command line. If you name 
more than one file, the we program counts the number of lines, words, and char- 
acters in each specified file and then totals the counts. In addition, you can direct 
the we program to give you only a line, a word, or a character count by using the 
—l, —w, or —c options, respectively. 


To determine the number of lines, words, and characters in a file, use the fol- 
lowing format on the command line: 


we filel <CR> 


The system responds with a line in the following format: 
l w C filel 

where 

m™ / represents the number of lines in filel 

™ w represents the number of words in filel 

™ c represents the number of characters in file! 

For example, to count the lines, words, and characters in the file johnson 
(located in the current directory, letters), type the following command line: 


$ we johnson<CR> 
24 66 406 johnson 
$ 


The system response means that the file johnson has twenty-four lines, sixty-six 
words, and 406 characters. 


To count the lines, words, and characters in more than one file, use this for- 
mat: 


we filel file2<CR> 
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The system responds in the following format: 


l Ww c filel 
l Ww C file2 
l Ww Cc total 


Line, word, and character counts for filel and file2 are displayed on separate lines 
and the combined counts appear on the last line beside the word total. 


For example, ask the we program to count the lines, words, and characters in 
the files johnson and sanders in the current directory. 


$ we johnson sanders <CR> 
24 66 406 johnson 
28 92 559 sanders 


52 158 965 total 


The first line reports that the johnson file has twenty-four lines, sixty-six words, 
and 406 characters. The second line reports twenty-eight lines, ninety-two words, 
and 559 characters in the sanders file. The last line shows that these two files 
together have a total of fifty-two lines, 158 words, and 965 characters. 


To get only a line, a word, or a character count, select the appropriate com- 
mand line format from the following lines: 


we —I filel<CR> (line count) 
we —w filel<CR> (word count) 
we —c filel<CR> _ (character count) 
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For example, if you use the —I option, the system reports only the number of 
lines in sanders. 


$ we —l sanders<CR> 
28 sanders 


If the —w or ~—c option had been specified instead, the command would have 
reported the number of words or characters, respectively, in the file. 


Figure 3-23 summarizes the syntax and capabilities of the we command. 


Command Recap 


we — count lines, words, and characters in a file 


command options arguments 


—-l, -—w, —c file(s) 


Description: we counts lines, words, and characters in the specified 
file(s), keeping a total count of all tallies when more 
than one file is specified. 


Options —1 counts the number of lines in the specified 
file(s) 


—w counts the number of words in the specified 
file (s) 


—c counts the number of characters in the 
specified file(s) 


Remarks: When a file name is specified in the command line, 
it is printed with the count(s) requested. 


Figure 3-23: Summary of the we Command 
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Protecting Your Files: the chmod Command 


The command chmod (short for change mode) allows you to decide who can 
read, write, and use your files and who cannot. Because the UNIX operating sys- 
tem is a multi-user system, you usually do not work alone in the file system. Sys- 
tem users can follow path names to various directories and read and use files 
belonging to one another, as iong as they have permission to do so. 


If you own a file, you can decide who has the right to read it, write in it 
(make changes to it), or, if it is a program, to execute it. You can also restrict 
permissions for directories with the chmod command. When you grant execute 
permission for a directory, you allow the specified users to ed to it and list its con- 
tents with the Is command. 


To assign these types of permissions, use the following three symbols: 
r allows system users to read a file or to copy its contents 
w allows system users to write changes into a file (or a copy of it) 


x allows system users to run an executable file 


To specify the users to whom you are granting (or denying) these types of 
permission, use these three symbols: 


u you, the owner of your files and directories (u is short for user) 


g members of the group to which you belong (the group could consist of 
team members working on a project, members of a department, or a 
group arbitrarily designated by the person who set up your UNIX sys- 
tem account) 


o all other system users 


When you create a file or a directory, the system automatically grants or 
denies permission to you, members of your group, and other system users. You 
can alter this automatic action by modifying your environment (see Chapter 7 for 
details). Moreover, regardless of how the permissions are granted when a file is 
created, as the owner of the file or directory you always have the option of chang- 
ing them. For example, you may want to keep certain files private and reserve 
them for your exclusive use. You may want to grant permission to read and write 
changes into a file to members of your group and all other system users as well. 
Or you may share a program with members of your group by granting them per- 
mission to execute it. | 
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How to Determine Existing Permissions 


You can determine what permissions are currently in effect on a file or a 
directory by using the command that produces a long listing of a directory’s con- 
tents: ls —I. For example, typing Is —l and pressing the RETURN key while in 
the directory named starship/bin in the sample file system produces the following 
output: 


$ Ils -—1<CR> 
total 35 
-Ywxr-xr-x 1 starship 9346 Nov 1 08:06 display 


-Yw-r--r-- 1 starship 6428 Dec 2 10:24 list 
drwx--x--x 2 starship 32 Nov 8 15:32 tools 
$ 


Permissions for the display and list files and the tools directory are shown on 
the left of the screen under the line total 35, and appear in this format: 


-rwxr-xr-x _ (for the display file) 
-rw-r--r-- _ (for the list file)) 
drwx--x--- (for the tools directory) 


After the initial character, which describes the file type (for example, 
a — (dash) symbolizes a regular file and a CWd a directory), the other nine char- 
acters that set the permissions comprise three sets of three characters. The first 
set refers to permissions for the owner, the second set to permissions for group 
members, and the last set to permissions for all other system users. Within each 
set of characters, the r, w, and x show the permissions currently granted to each 
category. If a dash appears instead of an r, w, or x, permission to read, write, or 
execute is denied. 
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The following diagram summarizes this breakdown for the file named display. 


user group others 
rwxXr-xr-x 
SS Permission to write to 
the file denied to 
read group and other 
write 
execute 


As you can see, the owner has r, w, and x permissions and members of the group 
and other system users have r and x permissions. 


There are two exceptions to this notation system. Occasionally the letter s or 
the letter 1 may appear in the permissions line, instead of an r, wor x. The 
letter s (short for set user ID or set group ID) represents a special type of per- 
mission to execute a file. It appears where you normally see an x (or —) for the 
user or group (the first and second sets of permissions). From a user’s point of 
view it is equivalent to an x in the same position; it implies that execute permis- 
sion exists. It is significant only for programmers and system administrators. 


(See the System Administrator’s Guide for details about setting the user or group 
ID.) 


The letter | is the symbol for lock enabling. It does not mean that the file has 
been locked. It simply means that the function of locking is enabled, or possible, 
for this file. The file may or may not be locked; that cannot be determined by the 
presence or absence of the letter 1. 
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How to Change Existing Permissions 


After you have determined what permissions are in effect, you can change 
them by executing the chmod command in the following format: 


chmod who +permission file(s) <CR> 
or 
chmod who=permission file(s) <CR> 


The following list defines each component of this command line. 


chmod name of the program 
who one of three user groups (u, g, or o) 
u = user 
£ =~ group 
o = others 
+ or - instruction that grants (+) or denies (—) permission 


permission any combination of three authorizations (r, w, and x) 
= read 
w= write 
x = execute 


file(s) file (or directory) name(s) listed; assumed to be branches 
from your current directory, unless you use full path- 
names. 


The chmod command will not work if you type a space(s) between who, the 
NOTE| instruction that gives (+) or denies (—) permission, and the permission. 


The following examples show a few possible ways to use the chmod command. 
As the owner of display, you can read, write, and run this executable file. You 
can protect the file against being accidentally changed by denying yourself write 
(w) permission. To do this, type the command line: 


chmod u-—w display <CR> 
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After receiving the prompt, type Is —l and press the RETURN key to verify that 
this permission has been changed, as shown in the following screen. 


$ chmod u—w display <CR> 

$ Ils -—1<CR> 

total 35 

-Y-xr-xr-x 1 starship project 9346 Nov 1 08:06 display 


Yw-r--r-- 1 starship project 6428 Dec 2 10:24 list 
drwx--x--x 2 starship project 32 Nov 8 15:32 tools 
$ 


As you can see, you no longer have permission to write changes into the file. You 
will not be able to change this file until you restore write permission for yourself. 


Now consider another example. Notice that permission to write into the file 
display has been denied to members of your group and other system users. How- 
ever, they do have read permission. This means they can copy the file into their | 
own directories and then make changes to it. To prevent all system users from 
copying this file, you can deny them read permission by typing: 


chmod go—r display <CR> 


The g and o stand for group members and all other system users, respectively, and 
the —r denies them permission to read or copy the file. Check the results with 
the Is —I command. 


102 USER’S GUIDE 


Accessing and Manipulating Files 


$ chmod go —r display <CR> 

$ ls -—1<CR> 

total 35 

-Ywx--x--x 1 starship project 9346 Nov 1 08:06 display 


Yw-r--r-- 1 starship project 6428 Dec 2 10:24 list 
drwx--x--x 2 starship project 32 Nov 8 15:32 tools 
$ 


A Note on Permissions and Directories 


You can use the chmod command to grant or deny permission for directories 
as well as files. Simply specify a directory name instead of a file name on the 
command line. 


However, consider the impact on various system users of changing permissions 
for directories. For example, say you grant read permission for a directory to 
yourself (u), members of your group (g), and other system users (0). Every user 
who has access to the system will be able to read the names of the files contained 
in that directory by running the Ils —1l command. Similarly, granting write per- 
mission allows the designated users to create new files in the directory and remove 
existing ones. Granting permission to execute the directory allows designated 
users to move to that directory (and make it their current directory) by using the 
cd command. 


An Alternative Method 


There are two methods by which the chmod command can be executed. The 
method described above, in which symbols such as r, w, and x are used to specify 
permissions, is called the symbolic method. 


An alternative method is the octal method. Its format requires you to specify 
permissions using three octal numbers, ranging from 0 to 7. (The octal number 
system is different from the decimal system that we typically use on a day-to-day 
basis.) To learn how to use the octal method, see the chmod(1) page in the User’s 
Reference Manual. 
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Figure 3-24 summarizes the syntax and capabilities of the chmod command. 


Command Recap 


chmod — change permission modes for files (and directories) 
command instruction arguments 


who + — permission filename(s) 
directoryname(s) 


Description: chmod gives (+) or removes (—) permission to 
read, write, and execute files for three categories 
of system users: user (you), group (members of 
your group), and other (all other users able to 
access the system on which you are working). 


Remarks: The instruction set can be represented in either 
octal or symbolic terms. 


Figure 3-24: Summary of the chmod Command 


Advanced Commands 


Use of the commands already introduced will increase your familiarity with 
the file system. As this familiarity increases, so might your need for more sophis- 
ticated information processing techniques when working with files. This section 
introduces three commands that provide just that. 
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diff finds differences between two files 
grep __ searches for a pattern in a file 
sort sorts and merges files 


For additional information about these commands refer to the User’s Reference 
Manual. 


Identifying Differences Between Files: the diff Command 


The diff command locates and reports all differences between two files and 
tells you how to change the first file so that it is a duplicate of the second. The 
basic format for the command is: 


diff file! file2<CR> 


If filel and file2 are identical, the system returns a prompt to you. If they are 
not, the diff command instructs you on how to change the first file so it matches 
the second by using ed (line editor) commands. (See Chapter 5 for details about 
the line editor.) The UNIX system flags lines in file] (to be changed) with the < 
(less than) symbol, and lines in file2 (the model text) with the > (greater than) 
symbol. 


For example, say you execute the diff command to identify the differences 
between the files johnson and mcdonough. The mcdonough file contains the same 
letter that is in the johnson file, with appropriate changes for a different recipient. 
The diff command will identify those changes as follows: 
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3,6c3,6 

< Mr. Rom Johnson 
< Layton Printing 
< 52 Hudson Street 
< New York, N.Y. 


> Mr. J.J. McDonough 


> Ubu Press 

> 37 Chico Place 

> Springfield, N.J. 
9c9 

< Dear Mr. Johnson: 


> Dear Mr. McDonough: 


The first line of output from diff is : 
3,6c3,6 


This means that if you want johnson to match mcdonough, you must change (c) 
lines 3 through 6 in johnson to lines 3 through 6 in mcdonough. The diff com- — 
mand then displays both sets of lines. 


If you make these changes (using a text editor such as ed or vi), the johnson 
file will be identical to the sanders file. Remember, the diff command identifies 
differences between specified files. If you want to make an identical copy of a file, 
use the cp command. 


Figure 3-25 summarizes the syntax and capabilities of the diff command. 
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Command Recap 


diff — finds differences between two files 
command options arguments 
diff available* filel file2 


Description: The diff command reports what lines are different 
in two files and what you must do to make the 
first file identical to the second. 


Remarks: Instructions on how to change a file to bring it 
into agreement with another file are line editor 
(ed) commands: a (append), ¢ (change), and d 
(delete). Numbers given with a, c, or d show the 
lines to be modified. Also used are the symbols 
< (showing a line from the first file) and > 
(showing a line from the second file). 


. See the diff(1) page in the User’s Reference Manual for all available options and an 


explanation of their capabilities. 


Figure 3-25: Summary of the diff Command 


Searching a File for a Pattern: the grep Command 


You can instruct the UNIX system to search through a file for a specific 
word, phrase, or group of characters by executing the command grep (short for 
globally search for a regular expression and print). Put simply, a regular expres- © 


sion is any pattern of characters (be it a word, a phrase, or an equation) that you 
specify. 
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The basic format for the command line is: 


grep pattern file(s)<CR> 


For example, to locate any lines that contain the word automation in the file 
johnson, type: 


grep automation johnson<CR> 
The system responds: 


$ grep automation johnson<CR> 
and office automation software. 
$ 


The output consists of all the lines in the file johnson that contain the pattern for 
which you were searching (automation). 


If the pattern contains multiple words or any character that conveys special 
meaning to the UNIX system, (such as $, |, *, ?, and so on), the entire pattern 
must be enclosed in single quotes. (For an explanation of the special meaning for 
these and other characters see "Metacharacters" in Chapter 7.) For example, say 
you want to locate the lines containing the pattern office automation. Your 
command line and the system’s response will read: 


$ grep ‘office automation’ johnson<CR> 
and office automation software. 
$ 


But what if you cannot recall which letter contained a reference to office 
automation; your letter to Mr. Johnson or the one to Mrs. Sanders? Type the fol- 
lowing command line to find out: 


$ grep ‘office automation’ johnson sanders <CR> 
johnson:and office automation software. 
$ | 


The output tells you that the pattern office automation is found once in the 
johnson file. 


In addition to the grep command, the UNIX system provides variations of it 
called egrep and fgrep, along with several options that enhance the searching 
powers of the command. See the grep(1), egrep(1), and fgrep(1) pages in the 
User’s Reference Manual for further information about these commands. 
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Figure 3-26 summarizes the syntax and capabilities of the grep command. 


Command Recap 


grep — searches a file for a pattern 


command options arguments 


grep available* pattern file(s) 


Description: The grep command searches through specified 
file(s) for lines containing a pattern and then 
prints the lines on which it finds the pattern. If 
you specify more than one file, the name of the 
file in which the pattern is found is also reported. 


Remarks: If the pattern you give contains multiple words or 
special characters, enclose the pattern in single 
quotes on the command line. 


, See the grep(1) page in the User’s Reference Manual for all available options and 


an explanation of their capabilities. 


Figure 3-26: Summary of the grep Command 
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Sorting and Merging Files: the sort Command 


The UNIX system provides an efficient tool called sort for sorting and merg- 
ing files. The format for the command line is: 


sort file(s)<CR> 


This command causes lines in the specified files to be sorted and merged in the 
following order. 


m@ Lines beginning with numbers are sorted by digit and listed before lines 
beginning with letters. 


m Lines beginning with upper case letters are listed before lines beginning 
with lower case letters. 


m™ Lines beginning with symbols such as *, %, or @, are sorted on the basis 
of the symbol’s ASCII representation. 


For example, let’s say you have two files, group1 and group2, each containing 
a list of names. You want to sort each list alphabetically and then interleave the 
two lists into one. First, display the contents of the files by executing the cat 
command on each. 


$ cat group1<CR> 
Smith, Allyn 
Jones, Barbara 
Cook, Karen 
Moore, Peter 
Wolf, Robert 

$ cat group2<CR> 


Frank, M. Jay 
Nelson, James 
West, Donna 
Hill, Charles 
Morgan, Kristine 
$ 
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(Instead of printing these two files individually, you could have requested both 
files on the same command line. If you had typed cat group1 group2 and pressed 
the RETURN key, the output would have been the same.) 


Now sort and merge the contents of the two files by executing the sort com- 
mand. The output of the sort program will be printed on the terminal screen 
unless you specify otherwise. 


$ sort group] group2<CR> 
Cook, Karen 

Frank, M. Jay 

Hill, Charles 

Jones, Barbara 

Moore, Peter 


Morgan, Kristine 
Nelson, James 
Smith, Allyn 
West, Donna 
Wolf, Robert 

$ 


In addition to combining simple lists as in the example, the sort command can 
rearrange lines and parts of lines (called fields) according to a number of other 
specifications you designate on the command line. The possible specifications are 
complex and beyond the scope of this text. Refer to the User’s Reference Manual 
for a full description of available options. 


Figure 3-27 summarizes the syntax and capabilities of the sort command. 
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Command Recap 


sort — sorts and merges files 


command options arguments 


sort available* file(s) 


Description: The sort command sorts and merges lines from a 
file or files you specify and displays its output on 
your terminal screen. 


Remarks: If no options are specified on the command line, 
lines are sorted and merged in the order defined 
by the ASCII representations of the characters in 
the lines. 


* See the sort(1) page in the User’s Reference Manual for all available options and 


an explanation of their capabilities. 


Figure 3-27: Summary of the sort Command 
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This chapter described the structure of the file system and presented ways to 
use and to navigate through the file system by using UNIX system commands. 
The next chapter gives you an overview of a variety of UNIX system capabilities: 
text editing, using the shell as a command language, communicating electronically 
with other system users, and programming and developing software. 
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Introduction 


This chapter serves as a transition between the overview that comprises the 
first three chapters and the tutorials in the following four chapters. Specifically, it 
provides an overview of the subjects covered in these tutorials: text editing, work- 
ing in the shell, and communicating electronically. Text editing is covered in 
Chapter 5, "Line Editor Tutorial," and Chapter 6, "Screen Editor Tutorial." How 
to work and program in the shell is taught in Chapter 7, "Shell Tutorial," and 
methods of electronic communication are covered in Chapter 8, "Communication 
Tutorial." | 
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Using the file system is a way of life ina UNIX. system environment. This 
section will teach you how to create and modify files with a software tool called a 
text editor. The section begins by explaining what a text editor is and how it 
works. Then it introduces two types of text editors supported on the UNIX sys- 
tem: the line editor, ed, and the screen editor, vi (short for visual editor). A com- 
parison of the two editors is also included. For detailed information about ed and 
vi, see Chapters 5 and 6. 


What is a Text Editor? 


Whenever you revise a letter, memo, or report, you must perform one or more 
of the following tasks: insert new or additional material, delete unneeded material, 
transpose material (sometimes called cutting and pasting), and, finally, prepare a 
clean, corrected copy. Text editors perform these tasks at your direction, making 
writing and revising text much easier and quicker than if done by hand. 


The UNIX system text editors, like the UNIX system shell, are interactive 
programs; they accept your commands and then perform the requested functions. 
From the shell’s point of view, the editors are executable programs. 


A major difference between a text editor and the shell, however, is the set of 
commands that each recognizes. All the commands introduced up to this point 
belong to the shell’s command set. A text editor has its own distinct set of com- 
mands that allow you to create, move, add, and delete text in files, as well as 
acquire text from other files. 


How Does a Text Editor Work? 
To understand how a text editor works, you need to understand the environ- 


ment created when you use an editing program and the modes of operation under- 
stood by a text editor. 
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Text Editing Buffers 


When you use a text editor to create a new file or modify an existing one, you 
first ask the shell to put the editor in control of your computing session. As soon 
as the editor takes over, it allocates a temporary work space called the editing 
buffer; any information that you enter while editing a file is stored in this buffer 
where you can modify it. 


Because the buffer is a temporary work space, any text you enter and any 
changes you make to it are also temporary. The buffer and its contents will exist 
only as long as you are editing. If you want to save the file, you must tell the text 
editor to write the contents of the buffer into a file. The file is then stored in the 
computer’s memory. If you do not, the buffer’s contents will disappear when you 
leave the editing program. To prevent this from happening, the text editors send 
you a reminder to write your file if you attempt to end an editing session without 
doing so. | 


can choose to leave the editor without writing the file. By doing so, you leave the 


som If you have made a critical mistake or are unhappy with the edited version, you 
NOTE 
original file intact; the edited copy disappears. 


Regardless of whether you are creating a new file or updating an existing one, 
the text in the buffer is organized into lines. A line of text is simply a series of 
characters that appears horizontally across the screen and is ended when you 
press the RETURN key. Occasionally, files may contain a line of text that is too 
long to fit on the terminal screen. Some terminals automatically display the con- 
tinuation of the line on the next row of the screen; others do not. 


Modes of Operation 


Text editors are capable of understanding two modes of operation: command 
mode and text input mode. When you begin an editing session, you will be placed 
automatically in command mode. In this mode you can move around in a file, 
search for patterns in it, or change existing text. However, you cannot create text 
while you are in command mode. To do this you must be in text input mode. 
While you are in this mode, any characters you type are placed in the buffer as 
part of your text file. When you have finished entering text and want to run edit- 
ing commands again, you must return to command mode. 
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Because a typical editing session involves moving back and forth between 
these two modes, you may sometimes forget which mode you are working in. You 
may try to enter text while in command mode or to enter a command while in 
input mode. This is something even experienced users do from time to time. It 
will not take long to recognize your mistake and determine the solution after you 
complete the tutorials in Chapters 5 and 6. 


Line Editor 


The line editor, accessed by the ed command, is a fast, versatile program for 
preparing text files. It is called a line editor because it manipulates text on a 
line-by-line basis. This means you must specify, by line number, the line contain- 
ing the text you want to change. Then ed prints the line on the screen where you 
can modify it. 


This text editor provides commands with which you can change lines, print 
lines, read and write files, and enter text. In addition, you can invoke the line edi- 
tor from a shell program; something you cannot do with the screen editor. (See 
Chapter 7 for information on basic shell programming techniques.) 


The line editor (ed) works well on video display terminals and paper printing 
terminals. It will also accommodate you if you are using a slow-speed telephone 
line. (The visual editor, vi, can be used only on video display terminals.) Refer to 
Chapter 5, "Line Editor Tutorial," for instructions on how to use this editing tool. 
Also see Appendix C for a summary of line editor commands. 


Screen Editor 


The screen editor, accessed by the vi command, is a display-oriented, interac- 
tive software tool. It allows you to view the file you are editing a page at a time. 
This editor works most efficiently when used on a video display terminal operating 
at 1200 or higher baud. 


For the most part, you modify a file (by adding, deleting, or changing text) 
by positioning the cursor at the point on the screen where the modification is to be 
made and then making the change. The screen editor immediately displays the 
results of your editing; you can see the change you made in the context of the sur- 
rounding text. Because of this feature, the screen editor is considered more 
sophisticated than the line editor. 
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Furthermore, the screen editor offers a choice of commands. For example, a 
number of screen editor commands allow you to move the cursor around a file. 
Other commands scroll the file up or down on the screen. Still other commands 
allow you to change existing text or to create new text. In addition to its own set 
of commands, the screen editor can access line editor commands. 


The trade-off for the screen editor’s speed, visual appeal, efficiency, and power 
is the heavy demand it places on the computer’s processing time. Every time you 
make a change, no matter how simple, vi must update the screen. Refer to 
Chapter 6, "Screen Editor Tutorial," for instructions on how to use this editor. 
Appendix D contains a summary of screen editor commands, and Figure 4-1 com- 
pares the features of the line editor (ed) and the screen editor (vi). 
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Feature 


Recommended 
terminal type 


Speed 


Versatility 


Sophistication 


Advantages 


Line Editor (ed) 


Video display or 
paper-printing 


Accommodates high- 
and low-speed data 
transmission lines. 


Can be specified to run 
from shell scripts as 
well as used during 
editing sessions. 


Changes text quickly. 
Uses comparatively 
small amounts of pro- 
cessing time. 


Provides a full set of 
editing commands. 
Standard UNIX sys- 
tem text editor. 


There are fewer com- 
mands you must learn 
to use ed. 


Text Editing 


Screen Editor (vi) 


Video display 


Works best via high-speed 
data transmission lines 
(1200+ baud). 


Must be used interactively 
during editing sessions. 


Changes text easily. 
However, can make heavy 
demands on computer 
resources. 


Provides its own editing 
commands and recognizes 
line editor commands as 
well. 


vi allows you to see the 
effects of your editing in 
the context of a page of 


text, immediately. (When 


you use the ed editor, 
making changes and view- 
ing the results are 
separate steps.) 


Figure 4-1: Comparison of Line and Screen Editors (ed and vi) 
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Every time you log in to the UNIX system you start communicating with the 
shell, and continue to do so until you log off the system. However, while you are 
using a text editor, your interaction with the shell is suspended; it resumes as soon 
as you stop using the editor. 


The shell is much like other programs, except that instead of performing one 
job, as cat or Is does, it is central to your interactions with the UNIX system. 
The shell’s primary function is to act as a command interpreter between you and 
the computer system. As an interpreter, the shell translates your requests into 
language the computer understands, calls requested programs into memory, and 
executes them. | 


This section introduces methods of using the shell that enhance your ability to 
use system features. In addition to using it to run a single program, you may also 
use the shell to: 


™ interpret the name of a file or a directory you enter in an abbreviated way 
using a type of shell shorthand 


@ redirect the flow of input and output of the programs you run 

™ execute multiple programs simultaneously or in a pipeline format 

™ tailor your computing environment to.meet your individual needs 

In addition to being the command language interpreter, the shell is a pro- 
gramming language. For detailed information on how to use the shell as a com- 
mand interpreter and a programming language, refer to Chapter 7. Complete 


information about shell programming is available in a separate document, Shell 
Commands and Programming. 


Customizing Your Computing Environment 


This section deals with another control provided by the shell: your environ- 
ment. When you log in to the UNIX system, the shell automatically sets up a 
computing environment for you. The default environment set up by the shell 
includes these variables: 
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HOME your login directory 
LOGNAME your login name 


PATH route the shell takes to search for executable files or com- 
mands (typically PATH=:/bin:/usr/bin) 


The PATH variable tells the shell where to look for the executable program 
invoked by a command. Therefore it is used every time you issue a command. If 
you have executable programs in more than one directory, you will want all of 
them to be searched by the shell to make sure every command can be found. 


You can use the default environment supplied by your system or you can 
tailor an environment to meet your needs. If you choose to modify any part of 
your environment, you can use either of two methods to do so. If you want to 
change a part of your environment only for the duration of your current comput- 
ing session, specify your changes in a command line (see Chapter 7 for details). 
However, if you want to use a different environment (not the default environ- 
ment) regularly, you can specify your changes in a file that will set up the desired 
environment for you automatically every time you log in. This file must be called 
-profile and must be located in your home directory. 


The .profile typically performs some or all of the following tasks: checks for 
mail; sets data parameters, terminal settings, and tab stops; assigns a character or 
character string as your login prompt; and assigns the erase and kill functions to 
keys. You can define as few or as many tasks as you want in your .profile. You 
can also change parts of it at any time. For instructions on modifying a .profile, 
see "Modifying Your Login Environment" in Chapter 7. 


Now check to see whether or not you have a .profile. If you are not already 
in your home directory, cd to it. Then examine your .profile by issuing this com- 
mand: 3 


cat .profile 


If you have a .profile, its contents will appear on your screen. If you do not have 
a .profile you can create one with a text editor, such as ed or vi. (See "Modifying 
Your Login Environment" in Chapter 7 for instructions.) 
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Programming in the Shell 


The shell is not only the command language interpreter; it is also a command 
level programming language. This means that instead of always using the shell 
strictly as a liaison between you and the computer, you can also program it to 
repeat sequences of instructions automatically. To do this, you must create exe- 
cutable files containing lists of commands. These files are called shell procedures 
or shell scripts. Once you have a shell script for a particular task, you can simply 
request that the shell read and execute the contents of the script whenever you 
want to perform that task. 


Like other programming languages, the shell provides such features as vari- 
ables, control structures, subroutines, and parameter passing. These features 
enable you to create your own tools by linking together system commands. 


For example, you can combine three UNIX system programs (the date, who, 
and we commands) into a simple shell script called users that tells you the current 
date and time, and how many users are working on your system. If you use the vi 
editor (described in Chapter 6) to create your script, you can follow this pro- 
cedure. First, create the file users with the editor by typing 


vi users<CR> 


The editor will draw a blank page on your screen and wait for you to enter text. 
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cursor 


"users" [New file] 


Enter the three UNIX system commands on one line: 
date; who | we —1 


Then write and quit the file. Make users executable by adding execute permission 
with the chmod command. 


chmod ug +x users<CR> 


Now try running your new command. The following screen shows the kind of 
Output you will get. 


$ users<CR> 

Sat Mar 1 16:40:12 EST 1986 
4 

$ 
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The output tells you that four users were logged in on the system when you 
typed the command at 16:40 on Saturday, March 1, 1986. 


For step-by-step instructions on writing shell scripts and information about 
more sophisticated shell programming techniques, see Chapter 7, "Shell Tutorial." 
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As a UNIX system user, you can send messages or transmit information 
stored in files to other users who work on your system or another UNIX system. 
To do so, you must be logged in on a UNIX system that is capable of communi- 
cating with the UNIX system to which you want to send information. The com- 
mand you use to send information depends on what you are sending. This guide 
introduces you to these communication programs: 


mail 


mailx 


uucp 


uuto/uupick 


uux 


This command allows you to send messages or files to other 
UNIX system users, using their login names as addresses. It 
also allows you to receive messages sent by other users. mail 
holds messages and lets the recipient read them at his or her 
convenience. 


This command is a sophisticated, more powerful version of 
mail. It offers a number of options for managing the elect- 
ronic mail you send and receive. 


This command is used to send files from one UNIX system to 
another. (Its name is an acronym for UNIX to UNIX sys- 
tem copy.) You can use uucp to send a file to a directory you 
specify on a remote computer. When the file has been 
transferred, the owner of the directory is notified of its arrival 
by mail. 


These commands are used to send and retrieve files. You can 
use the uuto command to send a file(s) to a public directory; 
when it is available, the recipient is notified by mail that the 
file(s) has arrived. The recipient then can use the uupick 
command to copy the file(s) from the public directory to a 
directory of choice. 


This command lets you execute commands on a remote com- 
puter. It gathers files from various computers, executes the 
specified command on these files, and sends the standard out- 
put to a file on the specified computer. 


Chapter 8 offers tutorials on each of these commands. 
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Programming in the System 


The UNIX system provides a powerful and convenient environment for pro- 
gramming and software development, using the C programming language, | 
FORTRAN-77, BASIC, Pascal, and COBOL. As well, the UNIX system pro- 
vides some sophisticated tools designed to make software development easier and 
to provide a systematic approach to programming. 


For information on available UNIX system programming languages, see the 
Product Overview or Documentation Roadmap. 


For information on the general topic of programming in the UNIX system 
environment, see the Programmer’s Guide. Besides supplementing texts on pro- 
gramming languages, the Programmer’s Guide provides tutorials on the following 
five tools: 


SCCS Source Code Control System 

RJE Remote Job Entry (not available on all UNIX systems) 
make maintains programs 

lex generates programs for simple lexical tasks 

yacc generates parser programs 
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Introducing the Line Editor 


This chapter is a tutorial on the line editor, ed. ed is versatile and requires 
little computer time to perform editing tasks. It can be used on any type of ter- 
minal. The examples of command lines and system responses in this chapter will 
apply to your terminal, whether it is a video display terminal or a paper printing 
terminal. The ed commands can be typed in at your terminal or they can be used 
in a shell program (see Chapter 7, "Shell Tutorial"). 


ed is a line editor; during editing sessions it is always pointing at a single line 
in the file called the current line. When you access an existing file, ed makes the 
last line the current line so you can start appending text easily. Unless you 
specify the number of a different line or range of lines, ed will perform each com- 
mand you issue on the current line. In addition to letting you change, delete, or 


add text on one or more lines, ed allows you to add text from another file to the 
buffer. 


During an editing session with ed, you are altering the contents of a file in a 
temporary buffer, where you work until you have finished creating or correcting 
your text. When you edit an existing file, a copy of that file is placed in the 
buffer and your changes are made to this copy. The changes have no effect on 
the original file until you instruct ed, by using the write command, to move the 
contents of the buffer into the file. 


After you have read through this tutorial and tried the examples and exer- 
cises, you will have a good working knowledge of ed. The following basics are 
included: 


™ entering the line editor ed, creating text, writing the text to file, and quit- 
ting ed 


addressing particular lines of the file and displaying lines of text 
deleting text 


substituting new text for old text 


using special characters as shortcuts in search and substitute patterns 


moving text around in the file, as well as other useful commands and infor- 
mation 
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Suggestions for Using this Tutorial 


The commands discussed in each section are reviewed at the end of that sec- 
tion. A summary of all ed commands introduced in this chapter is found in 
Appendix C, where they are listed by topic. 


At the end of some sections, exercises are given so you can experiment with 
the commands. The answers to all exercises are at the end of this chapter. 


The notation conventions used in this chapter are those used throughout this 
Guide. They are described in the Preface. 
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The best way to learn ed is to log in to the UNIX system and try the exam- 
ples as you read this tutorial. Do the exercises; do not be afraid to experiment. 
As you experiment and try out ed commands, you will learn a fast and versatile 
method of text editing. 


In this section you will learn the commands used to: 

™ enter ed 

mM append text 

move up or down in the file to display a line of text 
delete a line of text 


write the buffer to a file 


quit ed 


How to Enter ed 


To enter the line editor, type ed and a file name: 
ed filename<CR> 
Choose a name that reflects the contents of the file. If you are creating a new 
file, the system responds with a question mark and the file name: 


$ ed new-file<CR> 
?new-file 


If you going to edit an existing file, ed responds with the number of characters in 
the file: 


$ ed old-file<CR> 
235 
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How to Create Text 


The editor receives two types of input, editing commands and text, from your 
terminal. To avoid confusing them, ed recognizes two modes of editing work: 
command mode and text input mode. When you work in command mode, any 
characters you type are interpreted as commands. In input mode, any characters 
you type are interpreted as text to be added to a file. 


Whenever you enter ed you are put into command mode. To create text in 
your file, change to input mode by typing a (for append), on a line by itself, and 
pressing the RETURN key: 


a<CR> 


Now you are in input mode; any characters you type from this point wil be added 
to your file as text. Be sure to type a on a line by itself; if you do not, the editor 
will not execute your command. 


After you have finished entering text, type a period on a line by itself. This 
takes you out of the text input mode and returns you to the command mode. 
Now you can give ed other commands. 


The following example shows how to enter ed, create text in a new file called 
try-me, and quit text input mode with a period. 


$ ed try-me<CR> 


This is the first line of text.<CR> 
This is the second line,<CR> 

and this is the third line. <CR> 
-<CR> 
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Notice that ed does not give a response to the period; it just waits for a new 
command. If ed does not respond to a command, you may have forgotten to type 
a period after entering text and may still be in text input mode. Type a period 
and press the RETURN key at the beginning of a line to return to command 
mode. Now you can execute editing commands. For example, if you have added 
some unwanted characters or lines to your text, you can delete them once you 
have returned to command mode. 


How to Display Text 


To display a line of a file, type p (for print) on a line by itself. The p com- 
mand prints the current line, that is, the last line on which you worked. Continue 
with the previous example. You have just typed a period to exit input mode. 
Now type the p command to see the current line. 


$ ed try-me<CR> 

? try-me 

a<CR> 

This is the first line of text.<CR> 
This is the second line, <CR> 


and this is the third line. <CR> 
.<CR> 
p<CR> 
and this is the third line. 


You can print any line of text by specifying its line number (also known as 
the address of the line). The address of the first line is 1; of the second, 2; and so 
on. For example, to print the second line in the file try-me, type: 


2p<CR> 
This is the second line, 
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You can also use line addresses to print a span of lines by specifying the 
addresses of the first and last lines of the section you want to see, separated by a 
comma. For example, to print the first three lines of a file, type: 


1,3p<CR> 


You can even print the whole file this way. For example, you can display a 
twenty-line file by typing 1,20p. If you do not know the address of the last line in 
your file, you can substitute a $ sign, ed symbol for the address of the last line. 
(These conventions are discussed in detail in the section "Line Addressing.") 


1,$p<CR> 
This is the first line of text. 
This is a second line, 


and this is the third line. 


If you forget to quit text input mode with a period, you will add text that you 
do not want. Try to make this mistake. Add another line of text to your try-me 
file and then try the p command without quitting text input mode. Then quit text 
input mode and print the entire file. 
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p<CR> 

and this is the third line. 
a<CR> 

This is the fourth line. <CR> 
p<CR> 

.<CR> 


1,$p<CR> 

This is the first line of text. 
This is the second line, 

and this is the third line. 
This is the fourth line. 

p 


What did you get? The next section will explain how to delete the unwanted line. 


How to Delete a Line of Text 


To delete text, you must be in the command mode of ed. Typing d deletes 
the current line. Try this command on the last example to remove the unwanted 
line containing p. Display the current line (p command), delete it (d command), 
and display the remaining lines in the file (p command). Your screen should look 
like this: 
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p<CR> 


p 
d<CR> 


1,$p<CR> 


This is the first line of text. 
This is a second line, 

and this is the third line. 
This is the fourth line. 


ed does not send you any messages to confirm that you have deleted text. 
The only way you can verify that the d command has succeeded is by printing the 
contents of your file with the p command. To receive verification of your deletion, 
you can put the d and p together on one command line. If you repeat the previ- 
ous example with this command, your screen should look like this: 


p<CR> 


p 
dp<CR> 


This is the fourth line. 
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How to Move Up or Down in the File 


To display the line below the current line, press the RETURN key while in 
command mode. If there is no line below the current line, ed responds with a ? 
and continues to treat the last line of the file as the current line. To display the 
line above the current line, press the minus key (—). 


The following screen provides examples of how both of these commands are 
used: 


p<CR> 

This is the fourth line. 
—<CR> 

and this is the third line. 
—-<CR> 

This is a second line, 


—-<CR> 

This is the first line of text. 
<CR> 

This is a second line, 

<CR> 

and this is the third line. 


Notice that by typing —<CR> or <CR>, you can display a line of text without 
typing the p command. These commands are also line addresses. Whenever you 
type a line address and do not follow it with a command, ed assumes that you 
want to see the line you have specified. Experiment with these commands: create 
some text, delete a line, and display your file. 
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How to Save the Buffer Contents in a File 


As we discussed earlier, during an editing session, the system holds your text 
in a temporary storage area called a buffer. When you have finished editing, you 
can save your work by writing it from the temporary buffer to a permanent file in 
the computer’s memory. By writing to a file, you are simply putting a copy of the 
contents of the buffer into the file. The text in the buffer is not disturbed, and 
you can make further changes to it. 


occurs (such as an accidental loss of power to your terminal), you may lose the 


som It is a good idea to write the buffer text into your file frequently. If an interrupt 
NOTE 
material in the buffer, but you will not lose the copy written to your file. 


To write your text to a file, enter the w command. You do not need to 
specify a file name; simply type w and press the RETURN key. If you have just 
created new text, ed creates a file for it with the name you specified when you 
entered the editor. If you have edited an existing file, the w command writes the 
contents of the buffer to that file by default. 


If you prefer, you can specify a new name for your file as an argument on the 
w command line. Be careful not to use the name of a file that already exists 
unless you want to replace its contents with the contents of the current buffer. ed 
will not warn you about an existing file; it will simply overwrite that file with your 
buffer contents. 


For example, if you decide you would prefer the try-me file to be called stuff, 
you can rename it: 
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$ ed try-me<CR> 

? try-me 

a<CR> 

This is the first line of text.<CR> 
This is the second line, <CR> 


and this is the third line. <CR> 


w stuff <CR> 
85 


Notice the last line of the screen. This is the number of characters in your text. 
When the editor reports the number of characters in this way, the write command 
has succeeded. 


How to Quit the Editor 


When you have completed editing your text, write it from the buffer into a 
file with the w command. Then leave the editor and return to the shell by typing 
q (for quit). 
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The system responds with a shell prompt. At this point the editing buffer van- 
ishes. If you have not executed the write command, your text in the buffer has 
also vanished. If you did not make any changes to the text during your editing 
session, no harm is done. However, if you did make changes, you could lose your 
work in this way. Therefore, if you type q after changing the file without writing 
it, ed warns you with a ?. You then have a chance to write and quit. 


If, instead of writing, you insist on typing q a second time, ed assumes you do 
not want to write the buffer’s contents to your file and returns you to the shell. 
Your file is left unchanged and the contents of the buffer are wiped out. 


You now know the basic commands needed to create and edit a file using ed. 
Figure 5-1 summarizes these commands. 
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enter ed to edit file 
append text after the current line 


quit text input mode and return to ed command 
mode. 


print text on your terminal 


delete text 


display the next line in the buffer (literally, car- 
riage return) 


display the next line in the buffer 
display the previous line in the buffer 
write the contents of the buffer to the file 


quit ed and return to the shell 


Figure 5-1: Summary of ed Editor Commands 
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Exercise | 


Answers for all the exercises in this chapter are found at the end of the 


chapter. However, they are not necessarily the only possible correct answers. 
Any method that enables you to perform a task specified in an exercise is correct, 
even if it does not match the answer given. 


]-1. 


1-2. 


140 


Enter ed with a file named junk. Create a line of text containing Hello 
World, write it to the file and quit ed. 


Now use ed to create a file called stuff. Create a line of text containing 
two words, Goodbye world, write this text to the file, and quit ed. 


Enter ed again with the file named junk. What was the editor’s response? 
Was the character count for it the same as the character count reported 
by the w command in Exercise 1-1? 


Display the contents of the file. Is that your file junk? 


How can you return to the shell? Try q without writing the file. Why do 
you think the editor allowed you to quit without writing to the buffer? 


Enter ed with the file junk. Add a line: 
Wendy’s horse came through the window. 


Since you did not specify a line address, where do you think the line was 
added to the buffer? Display the contents of the buffer. Try quitting the 
buffer without writing to the file. Try writing the buffer to a different file 
called stuff. Notice that ed does not warn you that a file called stuff 
already exists. You have erased the contents of stuff and replaced them 
with new text. 


USER’S GUIDE 


General Format of ed Commands 


ed commands have a simple and regular format: 
[address I[,address2\\commandlargument])<CR> 


The brackets around address1, address2, and argument show that these are 
optional. The brackets are not part of the command line. 


address1 ,address2 
The addresses give the position of lines in the buffer. 
Address! through address2 gives you a range of lines that 
will be affected by the command. If address2 is omitted, 
the command will affect only the line specified by address!1. 


command The command is one character and tells the editor what task 
to perform. 


argument The arguments to a command are those parts of the text 
that will be modified, or a file name, or another line address. 


This format will become clearer to you when you begin to experiment with 
the ed commands. 
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A line address is a character or group of characters that identifies a line of 
text. Before ed can execute commands that add, delete, move, or change text, it 
must know the line address of the affected text. Type the line address before the 
command: 


[address1),laddress2\command<CR> 
Both addressI and address2 are optional. Specify address1 alone to request 
action on a single line of text; both addressI and address2 to request a span of 


lines. If you do not specify any address, ed assumes that the line address is the 
current line. 


The most common ways to specify a line address in ed are: 


™ by entering line numbers (assuming that the lines of the files are consecu- 
tively numbered from 1 to n, beginning with the first line of the file) 


m™ by entering special symbols for the current line, last line, or a span of lines 
™ by adding or subtracting lines from the current line 

m™ by searching for a character string or word on the desired line 

You can access one line or a span of lines, or make a global search for all 


lines containing a specified character string. (A character string is a set of suc- 
cessive characters, such as a word.) 


Numerical Addresses 


ed gives a numerical address to each line in the buffer. The first line of the 
buffer is 1, the second line is 2, and so on, for each line in the buffer. Any line 
can be accessed by ed with its line address number. To see how line numbers 
address a line, enter ed with the file try-me and type a number. 
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$ ed try-me<CR> 
110 
1<CR> 


This is the first line of text. 
3<CR> 
and this is the third line. 


Remember that p is the default command for a line address specified without 
a command. Because you gave a line address, ed assumes you want that line 
displayed on your terminal. 


Numerical line addresses frequently change in the course of an editing ses- 
sion. Later in this chapter you will create lines, delete lines, or move a line to a 
different position. This will change the line address numbers of some lines. The 
number of a specific line is always the current position of that line in the editing 
buffer. For example, if you add five lines of text between line 5 and 6, line 6 
becomes line 11. If you delete line 5, line 6 becomes line 5. 


Symbolic Addresses 


Symbolic Address of the Current Line 


The current line is the line most recently acted on by any ed command. If 
you have just entered ed with an existing file, the current line is the last line of 
the buffer. The symbol for the address of the current line is a period. Therefore 
you can display the current line simply by typing a period (.) and pressing the 
RETURN key. 


Try this command in the file try-me: 
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$ ed try-me<CR> 
110 
-<CR> 


This is the fourth Line. 


The . is the address. Because a command is not specified after the period, ed 
executes the default command p and displays the line found at this address. 


To get the line number of the current line, type the following command: 
.=<CR> 


ed responds with the line number. For example, in the try-me file, the current 
line is 4. 


.<CR> 
This is the fourth line. 
-=<CR> 


4 
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Symbolic Address of the Last Line 


The symbolic address for the last line of a file is the $ sign. To verify that 
the $ sign accesses the last line, access the try-me file with ed and specify this 
address on a line by itself. (Keep in mind that when you first access a file, your 


current line is always the last line of the file.) 


$ ed try-me<CR> 
110 
.<CR> 


This is the fourth line. 
$<CR> 
This is the fourth line. 


Remember that the $ address within ed is not the same as the $ prompt from the 
shell. 


Symbolic Address of the Set of All Lines 


When used as an address, a comma (,) refers to all the lines of a file, from 
the first through the last line. It is an abbreviated form of the string mentioned 
earlier that represents all lines in a file, 1,$. Try this shortcut to print the con- 


tents of try-me: 


p<CR> 
This is the first line of text. 
This is the second line, 


and this is the third line. 
This is the fourth line. 
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Symbolic Address of the Current Line through the Last Line 


The semi-colon (;) represents a set of lines beginning with the current line 
and ending with the last line of a file. It is equivalent to the symbolic address .,§. 
Try it with the file try-me: 


2p<CR> 
This is the second line, 
3p<CR> 


This is the second line, 
and this is the third line. 
This is the fourth line. 


Relative Addresses: Adding or Subtracting Lines from the Current Line 


You may often want to address lines with respect to the current line. You 
can do this by adding or subtracting a number of lines from the current line with 
a plus (+) or a minus (—) sign. Addresses derived in this way are called relative 
addresses. To experiment with relative line addresses, add several more lines to 
your file try-me, as shown in the following screen. Also, write the buffer contents 
to the file so your additions will be saved: 
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$ ed try-me<CR> 

110 

.<CR> 

This is the fourth line. 
a<CR> 

five<CR> 

six <CR> 


seven <CR> 
eight<CR> 
nine <CR> 
ten<CR> 
-<CR> 
w<CR> 
140 


Now try adding and subtracting line numbers from the current line. 


4<CR> 
This is the fourth line. 
+3<CR> 


seven 
—-5<CR> 
This is a second line, 


What happens if you ask for a line address that is greater than the last line, or if 
you try to subtract a number greater than the current line number? 
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5<CR> 
five 
-—6<CR> 
? 


.=<CR> 
5 
+7<CR> 
? 


Notice that the current line remains at line 5 of the buffer. The current line 
changes only if you give ed a correct address. The ? response means there is an 
error. "Other Useful Commands and Information," at the end of this chapter, 
explains how to get a help message that describes the error. 


Character String Addresses 


You can search forward or backward in the file for a line containing a partic- 
ular character string. To do so, specify a string, preceded by a delimiter. 


Delimiters mark the boundaries of character strings; they tell ed where a 
string starts and ends. The most common delimiter is / (slash), used in the fol- 
lowing format: 


/pattern 


When you specify a pattern preceded by a / (slash), ed begins at the current line 
and searches forward (down through subsequent lines in the buffer) for the next 
line containing the pattern. When the search reaches the last line of the buffer, 
ed wraps around to the beginning of the file and continues its search from line 1. 


The following rectangle represents the editing buffer. The path of the arrows 
shows the search initiated by a /: 
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first line 


current line 


last line 


Another useful delimiter is ?. If you specify a pattern preceded by a ?, 
(?pattern), ed begins at the current line and searches backward (up through pre- 
vious lines in the buffer) for the next line containing the pattern. If the search 
reaches the first line of the file, it will wrap around and continue searching 


upward from the last line of the file. 


The following rectangle represents the editing buffer. The path of the arrows 
shows the search initiated by a ?: 


first line 


current line 
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Experiment with these two methods of requesting address searches on the file 
try-me. What happens if ed does not find the specified character string? 


$ ed try-me<CR> 
140 

.<CR> 

ten 

?first<CR> 


This is the first line of text. 
/fourth<CR> 

This is the fourth line. 

/junk <CR> 

? 


In this example, ed found the specified strings first and fourth. Then, because 
no command was given with the address, it executed the p command by default, 
displaying the lines it had found. When ed cannot find a specified string (such as 
junk), it responds with a ?. 


You can also use the / (slash) to search for multiple occurrences of a pattern 
without typing it more than once. First, specify the pattern by typing /pattern, as 
usual. After ed has printed the first occurrence, it waits for another command. 
Type / and press the RETURN key; ed will continue to search forward through 
the file for the last pattern specified. Try this command by searching for the 
word line in the file try-me: 
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.<CR> 
This is the first line of text. 
/ine<CR> 

This is the second line, 
/<CR> 

and this is the third line. 
/<CR> 

This is the fourth line. 
/<CR> 

This is the first line of text. 


Notice that after ed has found all occurrences of the pattern between the line 
where you requested a search and the end of the file, it wraps around to the 
beginning of the file and continues searching. 


Specifying a Range of Lines 


There are two ways to request a group of lines. You can specify a range of 
lines, such as address! through address2, or you can specify a global search for 
all lines containing a specified pattern. 


The simplest way to specify a range of lines is to use the line numbers of the 
first and last lines of the range, separated by a comma. Place this address before 
the command. For example, if you want to display lines 2 through 7 of the edit- 
ing buffer, give addressI as 2 and address2 as 7 in the following format: 


2,7p<CR> 
Try this on the file try-me: 
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2,7p<CR> 

This is the second line, 
and this is the third line. 
This is the fourth line. 


five 
six 
seven 


Did you try typing 2,7 without the p? What happened? If you do not add 
the p command, ed prints only address2, the last line of the range of addresses. 


Relative line addresses can also be used to request a range of lines. Be sure 
that address1 precedes address2 in the buffer. Relative addresses are calculated 
from the current line, as the following example shows: 


4<CR> 

This is the fourth line 
—2, +3p<CR> 

This is the second line, 
and this is the third line. 


This is the fourth line. 
five 

six 

seven 
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Specifying a Global Search 

There are two commands that do not follow the general format of ed com- 
mands: g and v. These are global search commands that specify addresses with a 
character string (pattern). The g command searches for all lines containing the 
string pattern and performs the command on those lines. The v command 
searches for all lines that do not contain the pattern and performs the command 
on those lines. 


The general format for these commands is: 


g/pattern/command <CR> 
v/pattern/command <CR> 


Try these commands by using them to search for the word line in try-me: 


g/line/p<CR> 

This is the first line of text. 
This is the second line, 

and this is the third line. 
This is the fourth line 


v/line/p<CR> 
five 
six 


seven 
eight 
nine 
ten 
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Notice the function of the v command: it finds all the lines that do not con- 
tain the word specified in the command line (line). 


Once again, the default command for the lines addressed by g or v is p; you 
do not need to include a p as the last delimiter on your command line. 


g/line<CR> 
This is the first line of text. 
This is the second line, 


and this is the third line. 
This is the fourth line 


However, if you are giving line addresses to be used by other ed commands, you 
need to include beginning and ending delimiters. You can use any of the methods 
discussed in this section to specify line addresses for ed commands. Figure 5-2 
summarizes the symbols and commands available for addressing lines. 
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the number of a line in the buffer 


the current line (the line most recently acted on by an ed 
command) 


the command used to request the line number of the current 
line 


the last line of the file 

the set of lines from line 1 through the last line 

the set of lines from the current line through the last line 
the line that is located n lines after the current line 

the line that is located n lines before the current line 


the command used to search forward in the buffer for the first 
line that contains the pattern abc 


the command used to search backward in the buffer for the 
first line that contains the pattern abc 


the set of all lines that contain the pattern abc 


the set of all lines that do NOT contain the pattern abc 


Figure 5-2: Summary of Line Addressing 
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Exercise 2 


2-1. 


2-2. 
2-3. 


2-4. 
2-5. 
2-6. 


2-7. 
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Create a file called towns with the following lines: 


My kind of town is 

Chicago 

Like being no where at all in 

Toledo 

I lost those little town blues in 

New York 

I lost my heart in 

San Francisco 

I lost $$ in 

Las Vegas 

Display line 3. 

If you specify a range of lines with the relative address —2,+3p, what 
lines are displayed ? 

What is the current line number? Display the current line. 
What does the last line say? 


What line is displayed by the following request for a search? 
?town<CR> 

After ed responds, type this command alone on a line: 
?<CR> 


What happened? 


Search for all lines that contain the pattern in. Then search for all lines 
that do NOT contain the pattern in. 
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ed provides two commands for displaying lines of text in the editing buffer: p 
and n. 


Displaying Text Alone: the p Command 
You have already used the p command in several examples. You are prob- 
ably now familiar with its general format: 
[address1,address2\p<CR> 


p does not take arguments. However, it can be combined with a substitution com- 
mand line. This will be discussed later in this chapter. 


Experiment with the line addresses shown in Figure 5-3 on a file in your 
home directory. Try the p command with each address and see if ed responds as 
described in the figure. 
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Specify this Address Check for this Response 


1,$p<CR> ed should display the entire file on your 
terminal. 


—5p<CR> ed should move backward five lines from 
the current line and display the line 
found there. 


+2p<CR> ed should move forward two lines from 
the current line and display the line 
found there. 


1,/x/p<CR> ed displays the set of lines from line one 
through the first line after the current 
line that contains the character x. It is 


important to enclose the letter x between 
slashes so that ed can distinguish between 
the search pattern address (x) and the ed 
command (p). 


Figure 5-3: Sample Addresses for Displaying Text 


Displaying Text with Line Addresses: the n Command 


The n command displays text and precedes each line with its numerical line 
address. It is helpful when you are deleting, creating, or changing lines. The 
general command line format for n is the same as that for p. 


[address1 ,address2\n<CR> 


Like p, n does not take arguments, but it can be combined with the substitute 
command. 
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Try running n on the try-me file: 


$ ed try-me<CR> 

140 

1,$n<CR> 

1 This is the first line of text. 
This is the second line, 

and this is the third line. 
This is the fourth line. 


five 
six 
seven 
eight 
nine 
ten 


=O On A UP WwW DN 


Figure 5-4 summarizes the ed commands for displaying text. 


Command Function 


displays specified lines of text in the editing buffer on your 
terminal 


displays specified lines of text in the editing buffer with 
their numerical line addresses on your terminal | 


Figure 5-4: Summary of Commands for Displaying Text 
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Creating Text 


ed has three basic commands for creating new lines of text: 
a append text 
i insert text 


c change text 


Appending Text: the a Command 


The append command, a, allows you to add text AFTER the current line or a 
specified address in the file. You have already used this command in the "Getting 
Started" section of this chapter. The general format for the append command line 
1S: 

[addressI]a<CR> 


Specifying an address is optional. The default value of address! is the current 
line. 


In previous exercises, you used this command with the default address. Now 
try using different line numbers for address]. In the following example, a new 
file called new-file is created. In the first append command line, the default 
address is the current line. In the second append command line, line 1 is specified 
as addressI. The lines are displayed with n so that you can see their numerical 
line addresses. Remember, the append mode is ended by typing a period (.) on a 
line by itself. 
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$ ed new—file<CR> 

Pnew-file 

a<CR> 

Create some lines 

of text in 

this file. 

.<CR> 

1,$n<CR> 
Create some lines 
of text in 
this file. 

la<CR> 

This will be line 2<CR> 

This will be line 3<CR> 

.<CR> 

1,$n<CR> 
Create some lines 
This will be line 2 
This will be line 3 
of text in 
this file. 


Notice that after you append the two new lines, the line that was originally 
line 2 (o£ text in) becomes line 4. 


You can take shortcuts to places in the file where you want to append text by 
combining the append command with symbolic addresses. The following three 
command lines allow you to move through and add to the text quickly in this way. 


a<CR> appends text after the current line 
$a<CR> appends text after the last line of the file 


0a<CR> appends text before the first line of the file (at a symbolic 
address called line 0) 
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To try using these addresses, create a one-line file called lines and type the 
examples shown in the following screens. (The examples appear in separate 
screens for easy reference only; it is not necessary to access the lines file three 
times to try each append symbol. You can access lines once and try all three con- 
secutively.) 


$ ed lines<CR> 

?lines 

a<CR> 

This is the current line.<CR> 

.<CR> 

p<CR> 

This is the current line. 

a<CR> 

This line is after the current line. <CR> 
.<CR> 

—1,._p<CR> 

This is the current line. 

This line is after the current line. 


$a<CR> 

This is the last line now.<CR> 
.<CR> 

$<CR> 

This is the last line now. 
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0a<CR> 
This is the first line now. <CR> 

This is the second line now. <CR> 

The line numbers change<CR> 

as lines are added. <CR> 

-<CR> 

1,4n<CR> 

1 This is the first line now. 
2 This is the second line now. 
3 The line numbers change 

4 as lines are added. 


Because the append command creates text after a specified address, the last 
example refers to the line before line 1 as the line after line 0. To avoid such cir- 
cuitous references, use another command provided by the editor: the insert com- 
mand, i. 


Inserting Text: the 1 Command 


The insert command (i), allows you to add text BEFORE a specified line in 
the editing buffer. The general command line format for i is the same as that for 
a. : 


laddress1]li<CR> 


As with the append command, you can insert one or more lines of text. To quit 
input mode, you must type a period (.) alone on a line. 


Create a file called insert in which you can try the insert command (i): 
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$ ed insert<CR> 
?insert 

a<CR> 

Line 1<CR> 
Line 2<CR> 


Line 3<CR> 
Line 4<CR> 
-<CR> 
w<CR> 

69 


Now insert one line of text above line 2 and another above line 1. Use the n com- 
mand to display all the lines in the buffer: 


2i<CR> 
This is the new line 2.<CR> 
.<CR> 
1,$n<CR> 
Line 1 
This is the new line 2. 
Line 2 
Line 3 
5 Line 4 
11<CR> 
This is the beginning. <CR> 
-<CR> 
1,$n<CR> 
In the beginning 
Line 1 
Now this is line 2 
Line 2 
Line 3 
Line 4 
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Experiment with the insert command by combining it with symbolic line 
addresses, as follows: 


m i1<CR> 
= $i<CR> 


Changing Text: the c Command 


The change text command (ce) erases all specified lines and allows you to 
create one or more lines of text in their place. Because ¢ can erase a range of 
lines, the general format for the command line includes two addresses. 


[address1,address2\e<CR> 


The change command puts you in text input mode. To leave input mode, type a 
period alone on a line. 


Address! is the first and address2 is the last of the range of lines to be 
replaced by new text. To erase one line of text, specify only address1. If no 
address is specified, ed assumes the current line is the line to be changed. 


Now create a file called change in which you can try this command. After 
entering the text shown in the screen, change lines one through four by typing 
1,4c: 
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1,5n<CR> 
line 
line 
line 
line 
line 

1,4¢c<CR> 


Change line 1<CR> 

and lines 2 through 4<CR> 
.<CR> 

1,$n<CR> 

1 change line 1 

2 and lines 2 through 4 
3 line 5 


Now experiment with c and try to change the current line: 


.<CR> 

line 5 

c<CR> 

This is the new line 5. 


.<CR> 
This is the new line 5. 


If you are not sure whether you have left text input mode, it is a good idea to 
type another period. If the current line is displayed, you know you are in the 
command mode of ed. 
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Figure 5-5 summarizes the ed commands for creating text. 


append text after the specified line in the buffer 


insert text before the specified line in the buffer 


change the text on the specified line(s) to new text 


quit text input mode and return to ed command mode 


Figure 5-5: Summary of Commands for Creating Text 
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3-1. Create a new file called ex3. Instead of using the append command to 
create new text in the empty buffer, try the insert command. What hap- 
pens? 


3-2. Enter ed with the file towns. What is the current line? 


Insert above the third line: 


Illinois <CR> 


Insert above the current line: 


or<CR> 
Naperville<CR> 


Insert before the last line: 


hotels n<CR> 


Display the text in the buffer preceded by line numbers. 


3-3. In the file towns, display lines 1 through 5 and replace lines 2 through 5 
with: 


London<CR> 
Display lines 1 through 3. 


3-4. After you have completed exercise 3-3, what is the current line? 


Find the line of text containing: 


Toledo 
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Replace 
Toledo 
with 


Peoria 


Display the current line. 


Exercise 3 


With one command line search for and replace: 


New York 
with: 


Iron City 
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Deleting Text 


This section discusses two types of commands for deleting text in ed. One 
type is to be used when you are working in command mode: d deletes a line and 
u undoes the last command. The other type of command is to be used in text 
input mode: <#> (the pound sign) deletes a character and <@> (the at sign) 
kills a line. The delete keys that are used in input mode are the same keys you 
use to delete text that you enter after a shell prompt. They are described in detail 
in "Correcting Typing Errors" in Chapter 2. 


Deleting Lines: the d Command 


You have already deleted lines of text with the delete command (d) in the 
"Getting Started" section of this chapter. 


The general format for the d command line is: 
[address1,address2\d<CR> 


You can delete a range of lines (address] through address2) or you can delete 
one line only (address1). If no address is specified, ed deletes the current line. 


The next example displays lines one through five and then deletes lines two 
through four: 


1,5n<CR> 


1 horse 

2 chickens 

3 ham tacos 

4 cans of mustard 
5 bails of hay 


1 horse 
5 bails of hay 
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How can you delete only the last line of a file? Using a symbolic line address 
makes this easy: 


$d<CR> 


How can you delete the current line? One of the most common errors in ed is 
forgetting to type a period to leave text input mode. When this happens, 
unwanted text may be added to the buffer. In the next example, a line containing 
a print command (1,$p) is accidentally added to the text before the user leaves 
input mode. Because this line was the last one added to the text, it becomes the 
current line. The symbolic address . is used to delete it. 


a<CR> 

Last line of text<CR> 
1,$p<CR> 

.<CR> 

p<CR> 


1,$p 

d<CR> 

p<CR> 

Last line of text. 


Before experimenting with the delete command, you may first want to learn 
about the undo command, u. 


Undoing the Previous Command: the u Command 


The command u (short for undo) nullifies the last command and restores any 
text changed or deleted by that command. It takes no addresses or arguments. 
The format is: 


u<CR> 


LINE EDITOR TUTORIAL (ed) 171 


Deleting Text 


One purpose for which the u command is useful is to restore text you have 
mistakenly deleted. If you delete all the lines in a file and then type p, ed will 
respond with a ? since there are no more lines in the file. Use the u command to 
restore them. 


1,$p<CR> 

This is the first line. 
This is the middle line. 
This is the last line. 

1,$d<CR> 


p<CR> 

? 

u<CR> 

p<CR> 

This is the last line. 


Now experiment with u: use it to undo the append command. 


-<CR> 

This is the only line of text 
a<CR> 

Add this line<CR> 

.<CR> 

1,$p<CR> 


This is the only line of text 
Add this line 

u<CR> 

1,$p<CR> 

This is the only line of text 
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u cannot be used to undo the write command (w) or the quit command (q). 
NOTE| However, u can undo an undo command (u). 


How to Delete in Text Input Mode 


While in text input mode, you can correct the current line of input with the 
same keys you use to correct a shell command line. By default, there are two 
keys available to correct text. The @ sign key kills the current line. The # sign 
key backs up over one character on the current line so you can retype it, thus 
effectively erasing the original character. (See "Correcting Typing Errors" in 
Chapter 2 for details.) 


As mentioned in Chapter 2, you can reassign the line kill and character erase 
functions to other keys if you prefer. (See "Modifying Your Login Environment" 
in Chapter 7 for instructions.) If you have reassigned these functions, you must 
use the keys you chose while working in ed; the default keys (@ and #) will no 
longer work. 


Escaping the Delete Function 


You may want to include an @ sign or a # sign as a character of text. To 
avoid having these characters interpreted as delete commands, you must precede 
them with a \ (backslash), as shown in the following example. 


a<CR> 
leave San Francisco \@ 20:15 on flight \#347 <CR> 


p<CR> 
leave San Francisco @ 20:15 on flight #347 
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Figure 5-6 summarizes the ed commands and shell commands for deleting 
text in ed. 


In command mode: 


<d> delete one or more lines of text 


<u> undo the previous command 


<@> delete the current command line 
In text input mode: 
<@> delete the current line 


<#> or 
<BACKSPACE> delete the last character typed in 


Figure 5-6: Summary of Commands for Deleting Text 
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You can modify your text with a substitute command. This command 
replaces the first occurrence of a string of characters with new text. The general 
command line format is 


[address1,address2\s/old_text/new_text/lcommand]<CR> 


Each component of the command line is described below. 


addressI,address2 


S 


/old_text 


/new_text 


The range of lines being addressed by s. The address can be 
one line, (address1), a range of lines (address] through 
address2), or a global search address. If no address is given, 
ed makes the substitution on the current line. 


The substitute command 


The argument specifying the text to be replaced is usually 
delimited by slashes, but can be delimited by other charac- 
ters such as a ? or a period. It consists of the words or char- 
acters to be replaced. The command will replace the first 
occurrence of these characters that it finds in the text. 


The argument specifying the text to replace old text. It is 
delimited by slashes or the same delimiters used to specify 
the old text. It consists of the words or characters that are 
to replace the old_text. 


/command Any one of the following four commands: 
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g Change all occurrences of ol/d_text on the specified lines. 


| Display the last line of substituted text, including nonprinting 
characters. (See the last section of this chapter, "Other Use- 
ful Commands and Information.") 


n Display the last line of the substituted text preceded by its 
numerical line address. 


p Display the last line of substituted text. 


Substituting on the Current Line 


The simplest example of the substitute command is making a change to the 
current line. You do not need to give a line address for the current line. 


s/old_text/new_text/<CR> 


The next example contains a typing error. While the line that contains it is 
still the current line, you make a substitution to correct it. The old text is the ai 
of airor and the new text is er. 


a<CR> 
In the beginning, I made an airor. 
.<CR> 


-.p<CR> 
In the beginning, I made an airor. 
s/ai/er<CR> 


Notice that ed gives no response to the substitute command. To verify that 
the command has succeeded in this case, you either have to display the line with p 
or n, or include p or n as part of the substitute command line. In the following 
example, n is used to verify that the word file has been substituted for the word 
toad. 
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-p<CR> 
This is a test toad 
s/toad/file/n<CR> 


1 This is a test file 


However, ed allows you one shortcut: it prints the results of the command 
automatically, if you omit the last delimiter after the new_text argument: 


.p<CR> 
This is a test file 
s/file/frog<CR> 


This is a test frog 


Substituting on One Line 


To substitute text on a line that is not the current line, include an address in 
the command line, as follows: 


[address1\s/old_text/new_text/<CR> 
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For example, in the following screen the command line includes an address 
for the line to be changed (line 1) because the current line is line 3: 


1,3p<CR> 

This is a pest toad 
testing testing 
come in toad 


-<CR> 

come in toad 
1s/pest/test <CR> 
This is a test toad 


As you can see, ed printed the new line automatically after the change was made, 
because the last delimiter was omitted. 


Substituting on a Range of Lines 
You can make a substitution on a range of lines by specifying the first 
address (address1) through the last address (address2). 
[address1,address2\s/old_text/new_text/<CR> 


If ed does not find the pattern to be replaced on a line, no changes are made to 
that line. 


In the following example, all the lines in the file are addressed for the substi- 
tute command. However, only the lines that contain the string es (the old_text 
argument) are changed. 
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1,$p<CR> 

This is a test toad 
testing testing 
come in toad 


testing 1, 2, 3 
1,$s/es/ES/n<CR> 
4 tESting 1, 2, 3 


When you specify a range of lines and include p or n at the end of the substitute 
line, only the last line changed is printed. 


To display all the lines in which text was changed, use the n or p command 
with the address 1,§. 


1,$n<CR> 
1 This is a tESt toad 
tESting testing 


2 
3 come in toad 
4 tESting 1, 2, 3 


Notice that only the first occurrence of es (on line 2) has been changed. To 
change every occurrence of a pattern, use the g command, described in the next 
section. 
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Global Substitution 


One of the most versatile tools in ed is global substitution. By placing the g 
command after the last delimiter on the substitute command line, you can change 
every occurrence of a pattern on the specified lines. Try changing every 
occurrence of the string es in the last example. If you are following along, doing 
the examples as you read this, remember you can use u to undo the last substitute 
command. 


u<CR> 

1,$p<CR> 

This is a test toad 
testing, testing 
come in toad 
testing 1, 2, 3 


1,$s/es/ES/g<CR> 
1,$p<CR> 

This is a tESt toad 
tESting tESting 
come in toad 
tESting 1, 2, 3 


Another method is to use a global search pattern as an address instead of the 
range of lines specified by 1,$. 
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1,$p<CR> 

This is a test toad 
testing testing 

come in toad 

testing 1, 2, 3 
g/test/s/es/ES/g <CR> 
1,$p<CR> 

This is a tESt toad 


If the global search pattern is unique and matches the argument old _text (text to 
be replaced), you can use an ed shortcut: specify the pattern once as the global 
search address and do not repeat it as an old_text argument. ed will remember 
the pattern from the search address and use it again as the pattern to be replaced. 


g/old_text/s//new_text/g<CR> 


i 


pom Whenever you use this shortcut, be sure to include two slashes (//) after the s. 
NOTE 
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1,$p<CR> 

This is a test toad 
testing testing 
come in toad 
testing 1, 2, 3 
g/es/s//ES/g<CR> 


1,$p<CR> 

This is a tESt toad 
tESting tESting 
come in toad 
tESting 1, 2, 3 


Experiment with other search pattern addresses: 


/pattern<CR> 
?pattern<CR> 
v/pattern<CR> 


See what they do when combined with the substitute command. In the following 
example, the v/pattern search format is used to locate lines that do not contain 
the pattern testing. Then the substitute command (s) is used to replace the 
existing pattern (in) with a new pattern (out) on those lines. 


v/testing/s/in/out <CR> 
This is a test toad 
come out toad 
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Notice that the line This is a test toad was also printed, even though no 
substitution was made on it. When the last delimiter is omitted, all lines found 
with the search address are printed, regardless of whether or not substitutions 
have been made on them. 


Now search for lines that do contain the pattern testing with the g com- 
mand. 


g/testing/s//jumping <CR> 
jumping testing 
jumping 1, 2, 3 


Notice that this command makes substitutions only for the first occurrence of the 
pattern (testing) in each line. Once again, the lines are displayed on your ter- 
minal because the last delimiter has been omitted. 
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4-1. 


4.3. 


184 


In your file towns change town to city on all lines but the line with lit- 
tle town on it. 


The file should read: 

My kind of city is 

London 

Like being no where at all in 
Peoria 

IT lost those little town blues in 
Iron City 

I lost my heart in 

San Francisco 

I lost $$ in 


hotels in 
Las Vegas 


Try using ? as a delimiter. Change the current line 
Las Vegas 
to 


Toledo 


Because you are changing the whole line, you can also do this by using 
the change command, c. 


Try searching backward in the file for the word 
lost 

and substitute 
found 


using the ? as the delimiter. Did it work? 
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4-4, Search forward in the file for 
no 
and substitute 
NO 
for it. What happens if you try to use ? as a delimiter? 


Experiment with the various command combinations available for addressing 
a range of lines and doing global searches. 


What happens if you try to substitute something for the $$ ? Try to substi- 
tute Big $ for $ on line 9 of your file. Type: 


9s/$/Big $<CR> 
What happened? 
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If you try to substitute the $ sign in the line 
I lost my $ in Las Vegas 


you will find that instead of replacing the $, the new text is placed at the end of 
the line. The § is a special character in ed that is symbolic for the end of the line. 


ed has several special characters that give you a shorthand for search patterns 
and substitution patterns. The characters act as wild cards. If you have tried to 
type in any of these characters, the result was probably different than what you 
had expected. 


The special characters are: 


Match any one character. 


= Match zero or more occurrences of the preceding character. 


es Match zero or more occurrences of any character following 
the period. 


Match the beginning of the line. 


$ Match the end of the line. 

\ Take away the special meaning of the special character that 
follows. 

& Repeat the old text to be replaced in the new text of the 


replacement pattern. 
[...] Match the first occurrence of a character in the brackets. 


[*...] Match the first occurrence of a character that is NOT in the 
brackets. 


186 USER’S GUIDE 


Special Characters 


In the following example, ed searches for any three-character sequence ending 
in the pattern at. 


1,$p<CR> 


goat 
g/.at<CR> 
rat 

cat 

goat 


Notice that the word goat is included because the string oat matches the string 
at. 


The * (asterisk) represents zero or more occurrences of a specified character 
in a search or substitute pattern. This can be useful in deleting repeated 
occurrences of a character that have been inserted by mistake. For example, sup- 
pose you hold down the R key too long while typing the word broke. You can use 
the * to delete every unnecessary R with one substitution command. 


p<CR> 
brrroke 
s/br*/br <<CR> 


broke 
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Notice that the substitution pattern includes the b before the first r. If the b 
were not included in the search pattern, the * would interpret it, during the 
search, as a zero occurrence of r, make the substitution on it, and quit. 
(Remember, only the first occurrence of a pattern is changed in a substitution, 
unless. you request a global search with g.) The following screen shows how the 
substitution would be made if you did not specify both the b and the r before the 


*, 


p<CR> 
brrroke 
s/r*/r<CR> 


rbrrroke 


If you combine the period and the *, the combination will match all charac- 
ters. With this combination you can replace all characters in the last part of a 
line: 


p<CR> 

Toads are slimy, cold creatures 
s/are.*/are wonderful and warm<CR> 
Toads are wonderful and warm 
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The .* can also replace all characters between two patterns. 


p<CR> 
Toads are slimy, cold creatures 
s/are.*cre/are wonderful and warm cre<CR> 


Toads are wonderful and warm creatures 


If you want to insert a word at the beginning of a line, use the ~ (circumflex) 
for the old text to be substituted. This is very helpful when you want to insert the 
same pattern in the front of several lines. The next example places the word all 
at the beginning of each line: 


1,$p<CR> 
creatures great and small 
things wise and wonderful 
things bright and beautiful 
1,$s/*/all /<CR> 


1,$p<CR> 

all creatures great and small 
all things wise and wonderful 
all things bright and beautiful 


The §$ sign is useful for adding characters at the end of a line or a range of 
lines: 
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1,$p<CR> 

I love 

I need 

I use 

The IRS wants my 
1,$s/$/ money. <CR> 


1,$p<CR> 

I love money. 

I need money. 

I use money. 

The IRS wants my money. 


In these examples, you must remember to put a space after the word all or 
before the word money because ed adds the specified characters to the very begin- 
ning or the very end of the sentence. If you forget to leave a space before the 
word money, your file will look like this: 


1,$s/$/money/<CR> 
1,$p<CR> 
I lovemoney 


I needmoney 
I usemoney 
The IRS wants mymoney 


The $ sign also provides a handy way to add punctuation to the end of a line: 
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1,$p<CR> 

I love money 

I need money 

I use money 

The IRS wants my money 
1,$s/$/./<CR> 


1,$p/<CR> 

I love money. 

I need money. 

I use money. 

The IRS wants my money. 


Because . is not matching a character (old text), but replacing a character 
(new text), it does not have a special meaning. To change a period in the middle 
of a line, you must take away the special meaning of the period in the old text. 
To do this, simply precede the period with a backslash (\). This is how you take 
away the special meaning of some special characters that you want to treat as 
normal text characters in search or substitute arguments. For example, the fol- 
lowing screen shows how to take away the special meaning of the period: 


p<CR> 
Way to go. Wow! 
s/\\.!<CR> 


Way to go! Wow! 
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The same method can be used with the backslash character itself. If you 
want to treat a \ as a normal text character, be sure to precede it with a \. For 
example, if you want to replace the \ symbol with the word backslash, use the 
substitute command line shown in the following screen: 


1,2p<CR> 
This chapter explains 
how to use the \. 


s/\\/backslash<CR> 
how to use the backslash. 


If you want to add text without changing the rest of the line, the & provides 
a useful shortcut. The & (ampersand) repeats the old text in the replacement 
pattern, so you do not have to type the pattern twice. For example: 


p<CR> 
The neanderthal skeletal remains 
s/thal/ & man’s/<CR> 


p<CR> 
The neanderthal man’s skeletal remains 


ed automatically remembers the last string of characters in a search pattern 
or the old text in a substitution. However, you must prompt ed to repeat the 
replacement characters in a substitution with the % sign. The % sign allows you 
to make the same substitution on multiple lines without requesting a global substi- 
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tution. For example, to change the word money to the word gold, repeat the last 
substitution from line 1 on line 3, but not on line 4. 


1,$n<CR> 
1 I love money 
2 I need food 


3 I use money 

4 The IRS wants my money 
1s/money/gold<CR> 

I love gold 


3s//% <CR> 

I use gold 

1,$n<CR> 

1 I love gold 

2 I need food 

3 I use gold 

4 The IRS wants my money 


ed automatically remembers the word money (the old text to be replaced), so 
that string does not have to be repeated between the first two delimiters. The % 
sign tells ed to use the last replacement pattern, gold. 


ed tries to match the first occurrence of one of the characters enclosed in 
brackets and substitute the specified old text with new text. The brackets can be 
at any position in the pattern to be replaced. 


In the following example, ed changes the first occurrence of the numbers 6, 
7, 8, or 9 to 4 on each line in which it finds one of those numbers: 
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1,$p<CR> 

Monday 33,000 
Tuesday 75,000 
Wednesday 88,000 
Thursday 62,000 


1,$s/167891/4<CR> 

Monday 33,000 
Tuesday 45,000 
Wednesday 48,000 
Thursday 42,000 


The next example deletes the Mr or Ms from a list of names: 


1,$p<CR> 

Mr Arthur Middleton 
Mr Matt Lewis 

Ms Anna Kelley 

Ms M. L. Hodel 
1,$s/Mirs] //<CR> 


1,$p<CR> 
Arthur Middleton 
Matt Lewis 

Anna Kelley 

M. L. Hodel 


If a * (circumflex) is the first character in brackets, ed interprets it as an 
instruction to match characters that are NOT within the brackets. However, if 
the circumflex is in any other position within the brackets, ed interprets it 
literally, as a circumflex. 
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1,$p<CR> 

grade A Computer Science 
grade B- Robot Design 
grade A Boolean Algebra 
grade D Jogging 

grade C Tennis 

1,$s/grade {“AB]/grade A<CR> 


1,$p<CR> 

grade A Computer Science 
grade B- Robot Design 
grade A Boolean Algebra 
grade A Jogging 

grade A Tennis 


Whenever you use special characters as wild cards in the text to be changed, 
remember to use a unique pattern of characters. In the above example, if you 
had used only 


1,$s/l"ABI/A <CR> 
you would have changed the g in the word grade to A. Try it. 


Experiment with these special characters. Find out what happens (or does 
not happen) if you use them in different combinations. 


Figure 5-7 summarizes the special characters for search or substitute pat- 
terns. 
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Match any one character in a search or substitute pattern. 


Match zero or more occurrences of the preceding character 
in a search or substitute pattern. 


Match zero or more occurrences of any characters following 
the period. 


Match the beginning of the line in the substitute pattern to 
be replaced or in a search pattern. 


Match the end of the line in the substitute pattern to be 


replaced. 


Take away the special meaning of the special character that 
follows in the substitute or search pattern. 


Repeat the old text to be replaced in the new text replace- 
ment pattern. 


Match the last replacement pattern. 
Match the first occurrence of a character in the brackets. | 


Match the first occurrence of a character that is NOT in the 
brackets. 


Figure 5-7: Summary of Special Characters 
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5-1. Create a file that contains the following lines of text. 
A Computer Science 
D Jogging 
C Tennis 


What happens if you try this command line: 
1,$s/[°AB]/A/<CR> 


Undo the above command. How can you make the C and D unique? 
(Hint: they are at the beginning of the line, in the position shown by the 
*.) Do not be afraid to experiment! 


5-2. Insert the following line above line 2: 
These are not really my grades. 


Using brackets and the * character, create a search pattern that you can 
use to locate the line you inserted. There are several ways to address a 
line. When you edit text, use the way that is quickest and easiest for 
you. 


5-3. Add the following lines to your file: 
I love money 
I need money 
The IRS wants my money 
Now use one command to change them to: 
It’s my money 


It’s my money 
The IRS wants my money 
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Using two command lines, do the following: change the word on the first 
line from money to gold, and change the last two lines from money to 
gold without using the words money or gold themselves. 


5-4. How can you change the line 
1020231020 
to 
10202031020 


without repeating the old digits in the replacement pattern? 


5-5. Create a line of text containing the following characters. 
NED" * 


Substitute a letter for each character. Do you need to use a backslash for 
every substitution? 
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You have now learned to address lines, create and delete text, and make sub- 
stitutions. ed has one more set of versatile and important commands. You can 
move, copy, or join lines of text in the editing buffer. You can also read in text 
from a file that is not in the editing buffer, or write lines of the file in the buffer 
to another file in the current directory. The commands that move text are: 


m move lines of text 

t copy lines of text 

j join contiguous lines of text 
Ww write lines of text to a file 

r read in the contents of a file 


Move Lines of Text 
The m command allows you to move blocks of text to another place in the 
file. The general format is: 


[address1 ,address2\mladdress3|}<CR> 


The components of this command line include: 


address1,address2 
The range of lines to be moved. If only one line is moved, only 
address1 is given. If no address is given, the current line is 
moved. 


m The move command. 

address3 Place the text after this line. 

Try the following example to see how the command works. Create a file that 
contains these three lines of text: 


I want to move this line. 
I want the first line 
below this line. 
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Type: 
1m3<CR> 


ed will move line 1 below line 3. 


I want to move this line. 


I want the first line 
below this line. 
I want to move this line. 


The next screen shows how this will appear on your terminal: 


1,$p<CR> 

I want to move this line. 
I want the first line 
below this line. 
1Im3<CR> 


1,$p<CR> 

I want the first line 
below this line. 

I want to move this line. 


If you want to move a paragraph of text, have address] and address2 define 
the range of lines of the paragraph. 


In the following example, a block of text (lines 8 through 12) is moved below 
line 65. Notice the n command that prints the line numbers of the file: 
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8,12n<CR> 

8 This is line 8. 

9 It is the beginning of a 
10 very short paragraph. 

11 This paragraph ends 

12 on this line. 
64,65n<CR> 

64 Move the block of text 
65 below this line. 


8,12m65<CR> 
59,65n<CR> 


Move the block of text 
below this line. 

This is line 8. 

It is the beginning of a 
very short paragraph. 
This paragraph ends 

on this line. 


How can you move lines above the first line of the file? Try the following 
command. 


3,4m0<CR> 
When address3 is 0, the lines are placed at the beginning of the file. 


Copy Lines of Text 


The copy command t (transfer) acts like the m command except that the 
block of text is not deleted at the original address of the line. A copy of that 
block of text is placed after a specified line of text. The general format of the 
command line is also similar. 


LINE EDITOR TUTORIAL (ed) 201 


Moving Text 


The general format of the t command also looks like the m command. 
[address1,address2\tladdress3|<CR> 


address1,address2 


The range of lines to be copied. If only one line is copied, only 
address! is given. If no address is given, the current line is 
copied. 


t The copy command. 


address3 __ Place the copy of the text after this line. 


The next example shows how to copy three lines of text below the last line. 


Safety procedures: 


If there is a fire in the building: 
Close the door of the room to seal off the fire 


Break glass of nearest alarm. 
Pull lever. 


Locate and use fire extinguisher. 


A chemical fire in the lab requires that you: 


Break glass of nearest alarm 
Pull lever 


Locate and use fire extinguisher 


The commands and ed’s responses to them are displayed in the next screen. 
Again, the n command displays the line numbers: 
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5,8n<CR> 
Close the door of the room, to seal off the fire. 
Break glass of nearest alarn. 
Pull lever. 
Locate and use fire extinguisher. 


30n<CR> 

30 A chemical fire in the lab requires that you: 
6,8t30 <CR> 

30,$n<CR> 


30 A chemical fire in the lab requires that you: 
31 Break glass of nearest alarm 
32 Pull lever 
33 Locate and use fire extinguisher 
6,8n<CR> 
Break glass of nearest alarm 
Pull lever 
Locate and use fire extinguisher 


The text in lines 6 through 8 remains in place. A copy of those three lines is _ 
placed after line 50. 


Experiment with m and t on one of your files. 


Joining Contiguous Lines 


The j command joins the current line with the following line. The general 
format is: 


[address1,address1\j<CR> 


The next example shows how to join several lines together. An easy way of 
doing this is to display the lines you want to join using p or n. 
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1,2p<CR> 
Now is the time to join 


Now is the time to join 
j<CR> 

p<CR> 

Now is the time to jointhe team. 


Notice that there is no space between the last word (join) and the first word 
of the next line (the), and the last word (play). You must place a space between 
them by using the s command. 


Write Lines of Text to a File 
The w command writes text from the buffer into a file. The general format 
is: 
[address1 ,address2\w |filename|<CR> 
address1,address2 


The range of lines to be placed in another file. If you do not use 
address1 or address2, the entire file is written into a new file. 


Ww The write command. 


filename The name of the new file that contains a copy of the block of 
text. 
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In the following example the body of a letter is saved in a file called memo, so 
that it can be sent to other people. 


March 17, 1986 
Dear Kelly, 
There will be a meeting in the 


green room at 4:30 P.M. today. 
Refreshments will be served. 
3,6w memo<CR> 
87 


The w command places a copy of lines three through six into a new file called 
memo. ed responds with the number of characters in the new file. 


Problems 


The w command overwrites preexisting files; it erases the current file and puts 
the new block of text in the file without warning you. If, in our example, a file 
called memo had existed before we wrote our new file to that name, the original 
file would have been erased. 


In "Special Commands," later in this chapter, you will learn how to execute 
shell commands from ed. Then you can list the file names in the directory to 
make sure that you are not overwriting a file. 


Another potential problem is that you cannot write other lines to the file 
memo. If you try to add lines 13 through 16, the existing lines (3 through 6) will 
be erased and the file will contain only the new lines (13 through 16). 
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Read in the Contents of a File 


The r command can be used to append text from a file to the buffer. The 
general format for the read command is: 


[address 1\r filename<CR> 


address1 The text will be placed after the line address1. If address!1 is not 
given, the file is added to the end of the buffer. 


r The read command. 


filename The name of the file that will be copied into the editing buffer. 


Using the example from the write command, the next screen shows a file 
being edited and new text being read into it. 


1,$n<CR> 
March 17, 1986 
Dear Michael, 
Are you free later today? 
Hope to see you there. 
3r memo<CR> 
87 


3,$n<CR> 


Are you free later today? 
There is a meeting in the 
green room at 4:30 P.M. today. 
Refreshments will be served. 
Hope to see you there. 


ed responds to the read command with the number of characters in the file being 
added to the buffer (in the example, memo). 
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It is a good idea to display new or changed lines of text to be sure that they 


are correct. 


Figure 5-8 summarizes the ed commands for moving text. 


move lines of text 


copy lines of text 


join contiguous lines 


write text into a new file 


read in text from another file 


Figure 5-8: Summary of ed Commands for Moving Text 
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6-1. 


6-2. 


6-3. 
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There are two ways to copy lines of text in the buffer: by issuing the 
copy command; or by using the write and read commands to first write 
text to a file and then read the file into the buffer. 


Writing to a file and then reading the file into the buffer is a longer pro- 
cess. Can you think of an example where this method would be more 
practical? 


What commands can you use to copy lines 10 through 17 of file exer into 
the file exer6 at line 7? 


Lines 33 through 46 give an example that you want placed after line 3, 


_ and not after line 32. What command performs this task? 


Say you are on line 10 of a file and you want to join lines 13 and 14. 
What commands can you issue to do this? 
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There are four other commands and a special file that will be useful to you 
during editing sessions. 


h,H access the help commands, which provide error messages 

| display characters that are not normally displayed 

f display the current file name 

! temporarily escape ed to execute a shell command 

ed. hup When a system interrupt occurs, the ed buffer is saved in a spe- 


cial file named ed.hup. 


Help Commands 


You may have noticed when you were editing a file that ed responds to some 
of your commands with a ?. The ? is a diagnostic message issued by ed when it 
has found an error. The help commands give you a short message to explain the 
reason for the most recent diagnostic. 


There are two help commands: 


h Display a short error message that explains the reason for the most 
recent ?. 


H_ Place ed into help mode so that a short error message is displayed every 
time the ? appears. (To cancel this request, type H.) 


You know that if you try to quit ed without writing the changes in the buffer 
to a file, you will get a ?. Do this now. When the ? appears, type h: 
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The ? is also displayed when you specify a new file name on the ed command 
line. Give ed a new file name. When the ? appears, type h to find out what the 
error message means. 


ed newfile<CR> 
? newfile 
h<CR> 


cannot open input file 


This message means one of two things: either there is no file called newfile or 
there is such a file but ed is not allowed to read it. 


As explained earlier, the H command responds to the ? and then turns on the 
help mode of ed, so that ed gives you a diagnostic explanation every time the ? is 
displayed subsequently. To turn off help mode, type H again. The next screen 
shows H being used to turn on help mode. Sample error messages are also 
displayed in response to some common mistakes: 
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$ ed newfile<CR> 

e newfile<CR> 
?newfile 

H<CR> 

cannot open input file 
/hello<CR> 

? 

illegal suffix 
1,22p<CR> 

? 

line out of range 
a<CR> 

I am appending this line to the buffer. 
.<CR> 

s/$ tea party<CR> 

? 

illegal or missing delimiter 
»$s/$/ tea party <CR> 

? 

unknown command 
H<CR> 

q<CR> 

? 

h<CR> 

warning: expecting ‘w’ 


These are some of the most common error messages that you may encounter dur- 
ing editing sessions: 


illegal suffix 
ed cannot find an occurrence of the search pattern hello because the 
buffer is empty. 


line out of range 


ed cannot print any lines because the buffer is empty or the line specified 
is not in the buffer. 
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A line of text is appended to the buffer to show you some error messages associ- 
ated with the s command. 


illegal or missing delimiter 
The delimiter between the old text to be replaced and the new text is 
missing. | 


unknown command 
addressI was not typed in before the comma; ed does not recognize ,$. 


Help mode is then turned off and h is used to determine the meaning of the 
last ? . While you are learning ed, you may want to leave help mode turned on. 
If so, use the H command. However, once you become adept at using ed, you will 
only need to see error messages occasionally. Then you can use the h command. 


Display Nonprinting Characters 


If you are typing a tab character, the terminal will normally display up to 
eight spaces (covering the space up to the next tab setting. (Your tab setting may 
be more or less than eight spaces. See Chapter 7, "Shell Tutorial," on setting 
using stty). 


If you want to see how many tabs you have inserted into your text, use the 1 
(list) command. The general format for the | command is the same as for n and 


p. 
[address1 ,address2)\<CR> 


The components of this command line are: 


address1,address2 
The range of lines to be displayed. If no address is 
given, the current line will be displayed. If only 
addressI is given, only that line will be displayed. 
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l The command that displays the nonprinting characters 
along with the text. 


The I command denotes tabs with a > (greater than) character. To type 
control characters, hold down the CONTROL key and press the appropriate 
alphabetic key. The key that sounds the bell is “g (control-g). It is displayed as 
\07 which is the octal representation (the computer’s code) for “g. 


Type in two lines of text that contain a <“g> (control-g) and a tab. Then 
use the | command to display the lines of text on your terminal. 


a<CR> 

Add a <“g> (control-g) to this line. <CR> 
Add a <tab> (tab) to this line. <CR> 
.<CR> 


1,21<CR> 
Add a \07 (control-g) to this line.<CR> 
Add a > (tab) to this line.<CR 


Did the bell sound when you typed <“g>? 


The Current File Name 


In a long editing session, you may forget the file name. The f command will 
remind you which file is currently in the buffer. Or, you may want to preserve 
the original file that you entered into the editing buffer and write the contents of 
the buffer to a new file. In a long editing session, you may forget, and acciden- 
tally overwrite the original file with the customary w and q command sequence. 
You can prevent this by telling the editor to associate the contents of the buffer 
with a new file name while you are in the middle of the editing session. This is 
done with the f command and a new file name. 
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The format for displaying the current file name is f alone on a line: 


f£<CR> 


To see how f works, enter ed with a file. For example, if your file is called oldfile, 
ed will respond as shown in the following screen: 


ed oldfile<CR> 
323 
f<CR> 


oldfile 


To associate the contents of the editing buffer with a new file name use this 
general format: 


f newfile<CR> 


If no file name is specified with the write command, ed remembers the file 
name given at the beginning of the editing session and writes to that file. If you 
do not want to overwrite the original file, you must either use a new file name 
with the write command, or change the current file name using the f command 
followed by the new file name. Because you can use f at any point in an editing 
session, you can change the file name immediately. You can then continue with 
the editing session without worrying about overwriting the original file. 


The next screen shows the commands for entering the editor with oldfile and 
then changing its name to newfile. A line of text is added to the buffer and then 
the write and quit commands are issued. 
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ed oldfile<CR> 
323 

f<CR> 
oldfile 

f newfile<CR> 
newfile 


a<CR> 

Add a line of text.<CR> 
.<CR> 

w<CR> 

343 

q<CR> 


Once you have returned to the shell, you can list your files and verify the 
existence of the new file, newfile. newfile should contain a copy of the contents of 
oldfile plus the new line of text. 


Escape to the Shell 


How can you make sure you are not overwriting an existing file when you 
write the contents of the editor to a new file name? You need to return to the 
shell to list your files. The ! allows you to temporarily return to the shell, execute 
a shell command, and then return to the current line of the editor. 


The general format for the escape sequence is: 


'shell command line<CR> 
shell response to the command line 
! 


When you type the ! as the first character on a line, the shell command must 
follow on that same line. The program’s response to your command will appear 
as the command is running. When the command has finished executing, the ! 
will be appear alone on a line. This means that that you are back in the editor at 
the current line. 


LINE EDITOR TUTORIAL (ed) 215 


Other Useful Commands and Information 


For example, if you want to return to the shell to find out the correct date, 
type ! and the shell command date. 


p<CR> 

This is the current line 

! date<CR> 

Tue Apr 1 14:24:22 EST 1986 


| 
p<CR> 
This is the current line. 


The screen first displays the current line. Then the command is given to tem- 
porarily leave the editor and display the date. After the date is displayed, you are 
returned to the current line of the editor. 


If you want to execute more than one command on the shell command line, 
see the discussion on ; in the section called "Special Characters" in Chapter 7. 


Recovering From System Interrupts 


What happens if you are creating text in ed and there is an interrupt to the 
system, you are accidentally hung up on the system, or your terminal is 
unplugged? When an interrupt occurs, the UNIX system tries to save the con- 
tents of the editing buffer in a special file named ed.hup. Later you can retrieve 
your text from this file in one of two ways. First, you can use a shell command to 
move ed.hup to another file name, such as the name the file had while you were 
editing it (before the interrupt). Second, you can enter ed and use the f com- 
mand to rename the contents of the buffer. An example of the second method is 
shown in the following screen: 
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ed ed.hup <CR> 
928 
f myfile<CR> 


myfile 


If you use the second method to recover the contents of the buffer, be sure to 
remove the ed.hup file afterward. 


Conclusion 


You now are familiar with many useful commands in ed. The commands | 
that were not discussed in this tutorial, such as G, P, Q and the use of () and {}, 
are discussed on the ed(1) page of the User’s Reference Manual. You can experi- 
ment with these commands and try them to see what tasks they perform. 


Figure 5-9 summarizes the functions of the commands introduced in this sec- 
tion. 
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Display a short error message for the preceding diag- 
nostic ?. 


Turn on help mode. An error message will be given 
with each diagnostic ?. The second H turns off help 
mode. 


I] Display nonprinting characters in the text. 
f Display the current file name. 


f newfile Change the current file name associated with the edit- 
ing buffer to new/file. 


!omd Temporarily escape to the shell to execute a shell 
command cmd. 


ed.hup The editing buffer is saved in ed.hup if the terminal is 
hung up before a write command. 


Figure 5-9: Summary of Other Useful Commands 
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Exercise 7 


7-1. 


7-2. 


7-3. 


Create a new file called newfilel. Access ed and change the file’s name to 
currentl. Then create some text and write and quit ed. Run the Is com- 
mand to verify that there is not a file called newfilel in your directory. If 
you do the shell command Is, you will see the directory does not contain a 
file called newfile1. 


Create a file named filel. Append some lines of text to the file. Leave 
append mode but do not write the file. Turn off your terminal. Then 
turn on your terminal and log in again. Issue the ls command in the 
shell. Is there a new file called ed.hup? Place ed.hup in ed. How can 
you change the current file name to filel? Display the contents of the 
file. Are the lines the same lines you created before you turned off your 
terminal? 


While you are in ed, temporarily escape to the shell and send a mail mes- 
sage to yourself. 
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Exercise ] 


1-1. 


$ ed junk<CR> 

? junk 

a<CR> 

Hello world. <CR> 
.<CR> 

w<CR> 

12 

q<CR> 

$ 


$ ed junk<CR> 
12 

1,$p<CR> 

Hello world.<CR> 
q<CR> 

$ 
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The system did not respond with the warning question mark because you did 
not make any changes to the buffer. 


1-3. 


$ ed junk<CR> 

12 

a<CR> 

Wendy’s horse came through the window. <CR> 
.<CR> 

1,$p<CR> 

Hello world. 


Wendy’s horse came through the window. 
q<CR> 

? 

w stuff <CR> 

60 

q<CR> 

$ 


LINE EDITOR TUTORIAL (ed) 221 


Answers to Exercises 


Exercise 2 
2-1. 


$ ed towns<CR> 

? towns 

a<CR> 

My kind of town is<CR> 

Chicago <CR> 

Like being no where at all in<CR> 
Toledo<CR> 

I lost those little town blues in<CR> 
New York<CR> 

I lost my heart n<CR> 

San Francisco <CR> 

I lost $$ in<CR> 

Las Vegas<CR> 

.<CR> 

w<CR> 

164 


3<CR> 
Like being no where at all in 
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2-3. 


—2,+3p<CR> 

My kind of town is 

Chicago 

Like being no where at all in 


Toledo 
I lost those little town blues in 


New York 


-=<CR> 
6 
6<CR> 
New York 


Answers to Exercises 
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2-5. 


$<CR> 
Las Vegas 


2-6. 


?town<CR> 
I lost those little town blues in 


?<CR> 


My kind of town is 
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2-7. 


g/in<CR> 

My kind of town is 

Like being no where at all in 

I lost those little town blues in 
I lost my heart in 

I lost $$ in 


v/in<CR> 
Chicago 
Toledo 

New York 

San Francisco 
Las Vegas 


Exercise 3 
3-1. 


$ ed ex3<CR> 
?ex3 
i<CR> 


? 
q<CR> 
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The ? after the i means there is an error in the command. There is no 
current line before which text can be inserted. 


3-2. 


$ ed towns<CR> 

164 

n<CR> 

10 Las Vegas 
3i<CR> 

Illinois<CR> 

-<CR> 

i<CR> 

or<CR> 

Naperville <CR> 

-<CR> 

$i<CR> 

hotels in<CR> 
1,$n<CR> 

my kind of town is 
Chicago 

or 

Naperville 
Illinois 

Like being no where at all in 
Toledo 

I lost those little town blues in 
New York 

I lost my heart in 
San Francisco 

I lost $$ in 
hotels in 

Las Vegas 


1 
2 
3 
4 
5 
6 
7 
8 
9 
10 
11 


Peak ars ee 
mW bY 
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Answers to Exercises 


3-3. 


1,5n<CR> 


1 My kind of town is 
2 Chicago 

3 or 

4 Naperville 

5 Illinois 
2,5¢<CR> 
London<CR> 

-<CR> 

1,3n<CR> 

1 My kind of town is 
2 London 

3 Like being no where at all 


.<CR> 

Like being no where at all 
/Tol<CR> 

Toledo 

c<CR> 

Peoria<CR> 

.<CR> 

-<CR> 

Peoria 
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3-5, 


.<CR> 
/New Y/c<CR> 
Iron City <<CR> 


.<CR> 
.<CR> 
Iron City 


Your search string need not be the entire word or line. It only needs to be 
unique. 


Exercise 4 
4-1, 


v/little town/s/town/city <CR> 
My kind of city is 

London 

Like being no where at all in 
Peoria 

Iron City 


I lost my heart in 
San Francisco 

I lost $$ in 
hotels in 

Las Vegas 


228 USER’S GUIDE 


Answers to Exercises 
The line 
I lost those little town blues in 
was not printed because it was NOT addressed by the v command. 


4-2. 


.<CR> 

Las Vegas 

s?Las Vegas?Toledo <CR> 
Toledo 


?lost?s? ?found <CR> 
I found $$ in 
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4.4. 


/no?s??NO<CR> 
? 
/no/s//NO<CR> 


Like being NO where at all in 


You cannot mix delimiters such as / and ? in a command line. 
The substitution command on line 9 produced this output: 
I found $$ inBig $ 


It did not work correctly because the $ sign is a special character in ed. 
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Exercise 5 
5-1. 


$ ed filel <CR> 

? filet 

a<CR> 

A Computer Science<CR> 
D Jogging <CR> 

C Tennis<CR> 
-<CR> 
1,$s/[°ABI/A/<CR> 
1,$p<CR> 

A Computer Science 
A Jogging 

A Tennis 

u<CR> 


1,$s/“l°AB]/A<CR> 
1,$p<CR> 
A Computer Science 
A Jogging 
A Tennis 
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Answers to Exercises 


5-2. 


2i<CR> 

These are not really my grades.<CR> 
1,$p<CR> 

A Computer Science 

These are not really my grades. 
A Tennis 

A Jogging 

/’°A]<CR> 

These are not really my grades 
?“IT]<CR> } 

These are not really my grades 


1,$p<CR> 

I love money 

I need money 

The IRS wants my money 
g/1/s/1.*m /It’s my m<CR> 
It’s my money 

It’s my money 
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/s/money/gold<CR> 
It’s my gold 

2,$s//% <CR> 

The IRS wants my gold 


s/10202/ & 0<CR> 
10202031020 


a<CR> 

* \&%* *<CR> 
.<CR> 
s/*/a<CR> 
a.\&%%* x 
s/*/b<CR> 
a.\&%%* b 


Answers to Exercises 
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Answers to Exercises 


Because there were no preceding characters, * substituted for itself. 


s/ \./e<CR> 
ac\&%%*b 
s/ \\/d<CR> 
acd&%“~b 


s/& /e<CR> 
acde%%*b 
s/% [f<CR> 
acdef*b 


The & and % are only special characters in the replacement text. 


s/ \"/g<CR> 
acdefgb 


Exercise 6 


6-1. Any time you have lines of text that you may want to have repeated 
several times, it may be easier to write those lines to a file and read in the 
file at those points in the text. 


If you want to copy the lines into another file you must write them to a 
file and then read that file into the buffer containing the other file. 
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ed exer <CR> 

725 

10,17 w temp<CR> 
210 

q<CR> 


ed exer6<CR> 
305 

Tr temp<CR> 
210 


The file temp can be called any file name. 


6-2. 


33,46m3 <CR> 
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6-3. 


-=<CR> 


10 
13p<CR> 


This is line 13. 
j<CR> 


~p<CR> 
This is line 13.and line 14. 


Remember that .= gives you the current line. 
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Exercise 7 
7-1. 


$ ed newfilel <CR> 

? newfile1 

f currentl<CR> 

current 1 

a<CR> 

This is a line of text<CR> 
Will it go into newfilel <CR> 
or into current! <CR> 
.<CR> 

w<CR> 

66 

q<CR> 

$ Is<CR> 

bin 

current‘ 


ed filel <CR> 

? file 

a<CR> 

I am adding text to this file.<CR> 
Will it show up in ed.hup? <CR> 
.<CR> 
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Answers to Exercises 


Turn off your terminal. 


Log in again. 


ed ed.hup<CR> 
58 

f filel <CR> 
file 
1,$p<CR> 

I am adding text to this file. 
Will it show up in ed.hup? 


$ ed filel <CR> 

58 

! mail mylogin< CR> 

You will get mail when<CR> 
you are done editing! <<CR> 


-<CR> 
' 
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CHAPTER 6: SCREEN EDITOR TUTORIAL (vi) 


Introduction 


This chapter is a tutorial on the screen editor, vi (short for visual editor). 
The vi editor is a powerful and sophisticated tool for creating and editing files. It 
is designed for use with a video display terminal which is used as a window 
through which you can view the text of a file. A few simple commands allow you 
to make changes to the text that are quickly reflected on the screen. 


The vi editor displays from one to many lines of text. It allows you to move 
the cursor to any point on the screen or in the file (by specifying places such as 
the beginning or end of a word, line, sentence, paragraph, or file) and create, 
change, or delete text from that point. You can also use some line editor com- 
mands, such as the powerful global commands that allow you to change multiple 
occurrences of the same character string by issuing one command. To move 
through the file, you can scroll the text forward or backward, revealing the lines 
below or above the current window, as shown in Figure 6-1. 


Not all terminals have text scrolling capability; whether or not you can take 
NOTE] advantage of vi’s scrolling feature depends on what type of terminal you have. 
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TEXT FILE 


You are in the screen editor. 


This part of the file is above 
the display window. You can 
place it on the screen by 
scrolling backward. 


This part of the file 
is in the display window. 


You can edit it. 


This part of the file is below 
the display window. You can 
place it on the screen by 

scrolling forward. 


Figure 6-1: Displaying a File with a vi Window 


{ 
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There are more than 100 commands within vi. This chapter covers the basic 
commands that will enable you to use vi simply but effectively. Specifically, it 
explains how to do the following tasks: 


set up your terminal so that vi is accessible 

enter vi, create text, delete mistakes, write the text to a file, and quit 
move text within a file 

electronically cut and paste text 

use special commands and shortcuts 

temporarily escape to the shell to execute shell commands 

use line editing commands available within vi 

edit several files in the same session 

recover a file lost by an interruption to an editing session 


change your shell environment to set your terminal configuration and an 
automatic carriage return 


Suggestions for Reading this Tutorial 


As you read this tutorial, keep in mind the notation conventions described in 
the Preface. In the screens in this chapter arrows are also used to show the posi- 
tion of the cursor. 


The commands discussed in each section are reviewed at the end of the sec- 
tion. A summary of vi commands is found in Appendix D, where they are listed 
by topic. At the end of some sections, exercises are given so you can experiment. 
The answers to all the exercises are at the end of this chapter. The best way to 
learn vi is by doing the examples and exercises as you read the tutorial. Log in on 
the UNIX system when you are ready to read this chapter. 
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The UNIX system is flexible; it can run on many types of computers and can 
be accessed from many kinds of terminals. However, because it is internally 
structured to be able to operate in so many ways, it needs to know what kind of 
hardware is being used in a given situation. 


In addition, the UNIX system offers various optional features for using your 
terminal that you may or may not want to incorporate into your computing ses- 
sion routine. Your choice of these options, together with your hardware 
specifications, comprise your login environment. Once you have set up your login 
environment, the shell implements these specifications and options automatically — 
every time you log in. 


This section describes two parts of the login environment: setting the terminal 
configuration, which is essential for using vi properly, and setting the wrapmargin, 
or automatic (carriage) RETURN, which is optional. 


Setting the Terminal Configuration 


Before you enter vi, you must set your terminal configuration. This simply 
means that you tell the UNIX system what type of terminal you are using. This 
is necessary because the software for the vi editor is executed differently on 
different terminals. 


Each type of terminal has several code names that are recognized by the 
UNIX system. Appendix F, "Setting Up the Terminal," tells you how to find a 
recognized name for your terminal. Keep in mind that many computer installa- 
tions add terminal types to the list of terminals supported by default in your 
UNIX system. It is a good idea to check with your local system administrator for 
the most up-to-date list of available terminal types. 


To set your terminal configuration, type 


TERM = terminal_name<CR> 
export TERM <CR> 
tput init<CR> 


The first line puts a value (a terminal type) in a variable called TERM. The 
second line exports this value; it conveys the value to all UNIX system programs 
whose execution depends on the type of terminal being used. 
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The tput command on the third line initializes (sets up) the software in your 
terminal so that it functions properly with the UNIX system. It is essential to 
run the tput init command when you are setting your terminal configuration 
because terminal functions such as tab settings will not work properly unless you 
do. 


For example, if your terminal is a Teletype 5425 this is how your commands 
will appear on the screen. 


$ TERM =5425<CR> 
$ export TERM <CR> 
$ tput-init<ER> 


Do not experiment by entering names for terminal types other than your ter- 
minal. This might confuse the UNIX system, and you may have to log off, hang 
up, or get help from your system administrator to restore your login environment. 


Changing Your Environment 


If you are going to use vi regularly, you should change your login environment 
permanently so you do not have to configure your terminal each time you log in. 
Your login environment is controlled by a file in your home directory called 
profile. (This file, pronounced dot profile, does not exist in the file system; you 
must create it. For details, see Chapter 7.) 


If you specify the setting for your terminal configuration in your .profile, your 
terminal will be configured automatically every time you log in. You can do this 
by adding the three lines shown in the last screen (the TERM assignment, export 
command, and tput command) to your .profile. (For detailed instructions, see 
Chapter 7.) 
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Setting the Automatic RETURN 


familiar with another text editor, such as ed, follow the instructions in this sec- 
tion. If you do not know how to use an editor but would like to have an 
automatic RETURN setting, skip this section for now and return to it when you 
have learned the basic skills taught in this chapter. 


som To set an automatic RETURN you must know how to create a file. If you are 
NOTE 


If you want the RETURN key to be entered automatically, create a file 
called .exre in your home directory. You can use the .exre file to contain options 
that control the vi editing environment. (For details about the .exre file, see the 
Editing Guide or Editing Utilities Guide.) 


To create a .exre file, enter an editor with that file name. Then type in one 
line of text: a specification for the wrapmargin (automatic carriage return) 
option. The format for this option specification is 


wm =n<CR> 


n represents the number of characters from the righthand side of the screen where 
you want an automatic carriage return to occur. For example, say you want a 
carriage return at twenty characters from the righthand side of the screen. Type 


wm =20<CR> 


Finally, write the buffer contents to the file and quit the editor (see "Text Editing 
Buffers" in Chapter 4). The next time you log in, this file will give you an 
automatic RETURN. 


To check your settings for the terminal and wrapmargin when you are in Vi, 
enter the command 


:set<CR> 


vi will report the terminal type and the wrapmargin, as well as any other options 
you may have specified. You can also use the :set command to create or change 
the wrapmargin option. Try experimenting with it. 
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Creating a File 


First, enter the editor; type vi and the name of the file you want to create or 
edit. 


vi filename<CR> 


For example, say you want to create a file called stuff. When you type the vi 
command with the file name stuff, vi clears the screen and displays a window in 
which you can enter and edit text. 


"stuff" [New file] 


The __ (underscore) on the top line shows the cursor waiting for you to enter 
a command there. (On video display terminals the cursor may be a blinking 
underscore or a reverse color block.) Every other line is marked with a ~ (tilde), 
the symbol for an empty line. 


If, before entering vi, you have forgotten to set your terminal configuration or 
have set it to the wrong type of terminal, you will see an error message instead. 
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$ vi stuff<CR> 
terminal name: unknown terminal type 


[Using open mode] 
"stuff" [New file] 


You cannot set the terminal configuration while you are in the editor; you must be 
in the shell. Leave the editor by typing 


>q<CR> 


Then set the correct terminal configuration. 


How to Create Text: the Append Mode 
If you have successfully entered vi, you are in command mode and vi is wait- 
ing for your commands. How do you create text? 


m Press the A key (<a>) to enter the append mode of vi. (Do not press the 
RETURN key.) You can now add text to the file. (An A is not printed on 
the screen.) 


m Type in some text. 
= To begin a new line, press the RETURN key. 
If you have specified the wrapmargin option in a .exre file, you will get a 


new line whenever you get an automatic RETURN (see "Setting the 
Automatic RETURN"). 


246 USER’S GUIDE 


Creating a File 


How to Leave Append Mode 


When you finish creating text, press the ESCAPE key to leave append mode 
and return to command mode. Then you can edit any text you have created or 
write the text in the buffer to a file. 


<a>Create some text<CR> 
in the screen editor <CR> 
and return to<CR> 


command mode. <ESC> 


If you press the ESCAPE key and a bell sounds, you are already in command 
mode. The text in the file is not affected by this, even if you press the ESCAPE 
key several times. 
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To edit an existing file you must be able to add, change, and delete text. 
However, before you can perform those tasks you must be able to move to the 
part of the file you want to edit. vi offers an array of commands for moving from 
page to page, between lines, and between specified points inside a line. These 
commands, along with commands for deleting and adding text, are introduced in 
this section. 


How to Move the Cursor 


To edit your text, you need to move the cursor to the point on the screen 
where you will begin the correction. This is easily done with four keys that are 
grouped together on the keyboard: h, j, k, and I. 


<h> moves the cursor one character to the left 
<j> moves the cursor down one line 

<k> moves the cursor up one line 

<I> moves the cursor one character to the right 


The <j> and <k> commands maintain the column position of the cursor. For 
example, if the cursor is on the seventh character from the left, when you type 
<j> or <k> it goes to the seventh character on the new line. If there is no 
seventh character on the new line, the cursor moves to the last character. 


Many people who use vi find it helpful to mark these four keys with arrows 
showing the direction in which each key moves the cursor. 
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2) 
SSSUa ERED SSB [or 
8 bi ae eve rete ee me 
. TT. LLEE} 6 i cE 
a Sle A Sw 


Some terminals have special cursor control keys that are marked with arrows. 
NOTE Use them in the same way you use the <h>, <j>, <k>, and <I> commands. 


Watch the cursor on the screen while you press the keys <h>, <j>, <k>, 
and <I>. Instead of pressing a motion command key a number of times to move 
the cursor a corresponding number of spaces or lines, you can precede the com- 
mand with the desired number. For example, to move two spaces to the right, 
you can press <I> twice or enter <21>. To move up four lines, press <k> 
four times or enter <4k>. If you cannot go any farther in the direction you 
have requested, vi will sound a bell. 


Now experiment with the j and k motion commands. First, move the cursor 
up seven lines. Type 


<7k> 
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The cursor will move up seven lines above the current line. If there are less than 
seven lines above the current line, a bell will sound and the cursor will remain on 
the current line. 


Now move the cursor down thirty-five lines. Type 
<35j> 


vi will clear and redraw the screen. The cursor will be on the thirty-fifth line 
below the current line, appearing in the middle of the new window. If there are 
less than thirty-five lines below the current line, the bell will sound and the cursor 
will remain on the current line. Watch what happens when you type the next 
command. | 


<35k> 


Like most vi commands, the <h>, <j>, <k>, and <I> motion commands 
are silent; they do not appear on the screen as you enter them. The only time you 
should see characters on the screen is when you are in append mode and are 
adding text to your file. If the motion command letters appear on the screen, you 
are still in append mode. Press the ESCAPE key to return to command mode 
and try the commands again. 


Moving the Cursor to the Right or Left 


In addition to the motion command keys <h> and <I>, the space bar and 
the BACKSPACE key can be used to move the cursor right or left to a character 
on the current line. 


<space bar> move the cursor one character to the right 
<nspace bar> move the cursor n characters to the right 
<BACKSPACE> move the cursor one character to the left 
<nBACKSPACE> move the cursor n characters to the left 

Try typing in a number before the command key. Notice that the cursor 


moves the specified number of characters to the left or right. In the example 
below, the cursor movement is shown by the arrows. 
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To move the cursor quickly to the right or left, prefix a number to the com- 
mand. For example, suppose you want to create four columns in your screen. 
After you’ve finished typing the headings for the first three columns, you notice a 
typing mistake. 


You want to correct your mistake before continuing. Exit insert mode and return 
to command mode by pressing the ESCAPE key; the cursor will move to the n. 
Then use the <h> command to move back five spaces. 


<x> <i>C<ESC> 
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Erase the c by typing <x>. Then change to insert mode (<i>), enter a C, fol- 
lowed by pressing the ESCAPE key. Use the <1> motion command to return to 
your earlier position. 


Colum 1 Columm 2 Colum 
<45i> 
Colum 1 Colum 2 Colum 


By now you may have discovered that you can move the cursor back and 
forth on a line by using the space bar and the BACKSPACE key. 


<space bar> move the cursor one character to the right 
<nspace bar> move the cursor n characters to the right 
<BACKSPACE> move the cursor one character to the left 
<nBACKSPACE> move the cursor n characters to the left 


Again, you can specify a multiple space movement by typing a number before 
pressing the space bar or BACKSPACE key. The cursor will move the number of 
characters you request to the left or right. 
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How to Delete Text 


If you want to delete a character, move the cursor to that character and press 
the <x>. Watch the screen as you do so; the character will disappear and the 
line will readjust to the change. To erase three characters in a row, press <x> 
three times. In the following example, the arrows under the letters show the posi- 
tions of the cursor. 


<x> delete one character 


<nx> delete n characters, where n is the number of characters 
you want to delete 


Hello wurld! 


<x> 


Hello wrid! 


Now try preceding <x> with the number of characters you want to delete. 
For example, delete the second occurrence of the word deep from the text shown 
in the following screen. Put the cursor on the first letter of the string you want to 
delete, and delete five characters (for the four letters of deep plus an extra 
space). 
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Tomorrow the Loch Ness monster 
shall slither forth from 
the deep dark deep depths of the lake. 


<5x> 


Tomorrow the Loch Ness monster 
shall slither forth from 
the deep dark depths of the lake. 


<5x> 


Notice that vi adjusts the text so that no gap appears in place of the deleted 
string. If, as in this case, the string you want to delete happens to be a word, you 
can also use the vi command for deleting a word. This command is described 
later in the section "Word Positioning." 
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How to Add Text 


There are two basic commands for adding text: the insert (<i>) and append 
(<a>) commands. To add text with the insert command at a point in your file 
that is visible on the screen, move the cursor to that point by using <h>, <j>, 
<k>,and <I>. Then press <i> and start entering text. As you type, the new 
text will appear on the screen to the left of the character on which you put the 
cursor. That character and all characters to the right of the cursor will move 
right to make room for your new text. The vi editor will continue to accept the 
characters you type until you press the ESCAPE key. If necessary, the original 
characters will even wrap around onto the next line. 


Hello Wrld! 


<i>o 


Helle World! 


You can use the append command in the same way. The only difference is 
that the new text will appear to the right of the character on which you put the 
cursor. 


Later in this tutorial you will learn how to move around on the screen or 
scroll through a file to add or delete characters, words, or lines. 
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When you have finished your text, you will want to write the buffer contents 
to a file and return to the shell. To do this, hold down the SHIFT key and press 
Z twice (<ZZ>). The editor remembers the file name you specified with the vi 
command at the beginning of the editing session, and moves the buffer text to the 
file of that name. A notice at the bottom of the screen gives the file name and the 
number of lines and characters in the file. Then the shell gives you a prompt. 


<a> This is a test file.<CR> 

I am adding text to<CR> 

a temporary buffer and<CR> 

now it is perfect.<CR> 

I want to write this file,<CR> 

and return to the shell.<ESC> <ZZ> 


"stuff" [New file] 7 lines, 151 characters 
$ 


You can also use the :w and :q commands of the line editor for writing and 
quitting a file. (Line.editor.commands begin with a colon and appear on the bot- 
tom line of the screen.) The :w command writes the buffer to a file. The q 
command leaves the editor and returns you to the shell. You can type these com- 
mands separately or combine them into the single command :wg. It is easier to 
combine them. 
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<a>This is a test file. <CR> 
I am adding text to<CR> 

a temporary buffer and<CR> 
now it is perfect.<CR> 

I want to write this file, <CR> 
and return to the shell.<ESC> 


Quitting vi 
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Quitting vi 


Figure 6-2 summarizes the basic commands you need to enter and use vi. 


Command 


TERM =terminal_name 
export TERM 


tput init 

vi filename 
<a> 
<h> 


<j> 


<k> 


Function 


set the terminal configuration 

initialize the terminal as defined by terminal_name 
enter vi editor to edit the file called filename 

add text after the cursor 

move one character to the left 

move down one line 

move up one line 

move one character to the right 

delete a character 

carriage return 


leave append mode, and return to vi 
command mode 


write to a file 
quit vi 
write to a file and quit vi 


write to a file and quit vi 


Figure 6-2: Summary of Commands for the vi Editor 
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Exercise 1 


Answers to the exercises are given at the end of this chapter. However, keep 
in mind that there is often more than one way to perform a task in vi. If your 
method works, it is correct. 


As you give commands in the following exercises, watch the screen to see how 
it changes or how the cursor moves. 


1-1. If you have not logged in yet, do so now. Then set your terminal 
configuration. 

1-2. Enter vi and append the following five lines of text to a new file called 
exer!. | 


This is an exercise! 
Up, down, 

left, right, 

build your terminal’s 
muscles bit by bit 


1-3. Move the cursor to the first line of the file and the seventh character from 
the right. Notice that as you move up the file, the cursor moves in to the 
last letter of the file, but it does not move out to the last letter of the next 
line. 


1-4. Delete the seventh and eighth characters from the right. 
1-5. Move the cursor to the last character on the last line of the text. 


1-6. Append the following new line of text: 


and byte by byte 
1-7. Write the buffer to a file and quit vi. 


1-8. Reenter vi and append two more lines of text to the file exer]. 
What does the notice at the bottom of the screen say once you have reen- 
' tered vi to edit exer1? 
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Until now you have been moving the cursor with the <h>, <j>, <k>, 
<I>, BACKSPACE key, and the space bar. There are several other commands 
that can help you move the cursor quickly around the screen. This section 
explains how to position the cursor in the following ways: 


™ by characters on a line 
™ by lines 
@ by text objects 

o words 

o sentences 

o paragraphs 


™ in the window 


There are also commands that position the cursor within parts of the vi editing 
buffer that are not visible on the screen. These commands will be discussed in the 
next section, "Positioning the Cursor in Undisplayed Text." 


To follow this section of the tutorial, you should enter vi with a file that con- 
tains at least forty lines. If you do not have a file of that length, create one now. 
Remember, to execute the commands described here, you must be in command 
mode of vi. Press the ESCAPE key to make sure that you are in command mode 
rather than append mode. 


Positioning the Cursor on a Character 


There are three ways to position the cursor on a character in a line. 
™ by moving the cursor right or left to a character 
™ by specifying the character at either end of the line 


™ by searching for a character on a line 


The first method was discussed earlier in this chapter under "Moving the Cursor 
to the Right or Left." The following sections describe the other two methods. 
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Moving the Cursor to the Beginning or End of a Line 


The second method of positioning the cursor on a line is by using one of three 
commands that put the cursor on the first or last character of a line. 


<$> puts the cursor on the last character of a line 
<O> (zero) puts the cursor on the first character of a line 
<*> (circumflex) puts the cursor on the first nonblank character of a line 


The following examples show the movement of the cursor produced by each of 
these three commands. 


Go to the end of the line! 


<$> 


Go to the end of the line! 


SCREEN EDITOR TUTORIAL (vi) 261 


Moving the Cursor Around the Screen 


262 


Go to the beginning of the line! 


<0> 
Go to the beginning of the line! 


Go to the first character 
of the line 
that is not blank! 


<*> 
Go to the first character 
of the line 
that is not blank! 
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Searching for a Character on a Line 


The third way to position the cursor on a line is to search for a specific char- 
acter on the current line. If the character is not found on the current line, a bell 
sounds and the cursor does not move. (There is also a command that searches a 
file for patterns. This will be discussed in the next section.) There are six com- 
mands you can use to search within a line: <f>, <F>, <t>, <T>, <;>, and 
<,>. You must specify a character after all of them except the <;> and <,> 
commands. 


<fx> Move the cursor to the right to the specified character x. 
<Fx> Move the cursor to the left to the specified character x. 


<tx> Move the cursor right to the character just before the specified char- 
acter Xx. 


<Tx> Move the cursor left to the character just after the specified character 
x. 


<;> Continue the search specified in the last command, in the same direc- 
tion. The ; remembers the character and seeks out the next 
occurrence of that character on the current line. 


<,> Continue the search specified in the last command, in the opposite 
direction. The , remembers the character and seeks out the previous 
occurrence of that character on the current line. 


For example, in the following screen vi searches to the right for the first 
occurrence of the letter A on the current line. 
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. Go forward to the letter A on this line. 


<fA> 


Go forward to the letter A on this line. 


Try the search commands on one of your files. 


Line Positioning 


Besides the <j> and <k> commands that you have already used, the 
<+>, <->, and <CR> commands can be used to move the cursor to other 
lines. 


The Minus Sign Motion Command 
The <-> command moves the cursor up a line, positioning it at the first non- 
blank character on the line. To move more than one line at a time, specify the 
number of lines you want to move before the <-> command. For example, to 
move the cursor up thirteen lines, type: 
<13-> 


The cursor will move up thirteen lines. If some of those lines are above the 
current window, the window will scroll up to reveal them. This is a rapid way to 
move quickly up a file. | 


Now try to move up 100 lines. Type: 
<100-> 


What happened to the window? If there are less then 100 lines above the current 
line a bell will sound, telling you that you have made a mistake, and the cursor 
will remain on the current line. 
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The Plus Sign Motion Command 


The plus sign command (< +>) or the <CR> command moves the cursor 
down a line. Specify the number of lines you want to move before the < +> 
command. For example, to move the cursor down nine lines, type: 


<9+> 


The cursor will move down nine lines. If some of those lines are below the current 
screen, the window will scroll down to reveal them. 


Now try to do the same thing by pressing the RETURN key. Were the resu- 
Its the same as when you pressed the + key? 


Word Positioning 


The vi editor considers a word to be a string of characters that may include 
letters, numbers, or underscores. There are six word positioning commands: 
<w>, <b>, <e>, <W>, <B>, and <E>. The lower case commands 
(<w>, <b>, and <e>) treat any character other than a letter, digit, or under- 
score as a delimiter, signifying the beginning or end of a word. Punctuation 
before or after a blank is considered a word. The beginning or end of a line is 
also a delimiter. 


The upper case commands (<W>, <B>, and <E>) treat punctuation as 
part of the word; words are delimited by blanks and newlines only. 


The following is a summary of the word positioning commands. 


<w> Move the cursor forward to the first character in the next word. You 
may press <w> as many times as you want to reach the word you 
want, or you can prefix the necessary number to the <w>. 


<nw> Move the cursor forward n number of words to the first character of 
that word. The end of the line does not stop the movement of the 
cursor; instead, the cursor wraps around and continues counting 
words from the beginning of the next line. 
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The <w> command 
leaps word by word through the 
file. Move from THIS word forward 


<6w> 


Six words to THIS word. 


The <w> command 

leaps word by word through the 
file. Move from THIS word forward 
six words to THIS word. 


<W> Ignore all punctuation and move the cursor forward to the word after 
the next blank. 


<e> Moves the cursor forward in the line to the last character in the next 
word. 
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Go forward one word to the end of 
the next word in this line 


Go forward one word to the end of 
the next word in this line 


Go to the end of the third word after the current word. 


SCREEN EDITOR TUTORIAL (vi) 267 


Moving the Cursor Around the Screen 


268 


Go to the end of the third word after the current word. 


<E> Ignores all punctuation except blanks, delimiting words only by 
blanks. 


<b> Move the cursor backward in the line to the first character of the pre- 
vious word. 


<nb> Move the cursor backward m number of words to the first character 
of the nth word. The <b> command does not stop at the beginning 
of a line, but moves to the end of the line above and continues mov- 
ing backward. 


<B> Can be used just like the <b> command, except that it delimits the 
word only by blank spaces and newlines. It treats all other punctua- 
tion as letters of a word. 


Leap backward word by word through 


the file. Go back four words from here. 
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the file. Go back four words from here. 


Positioning the Cursor by Sentences 


The vi editor also recognizes sentences. In vi a sentence ends in ! or . or ?. 
If these delimiters appear in the middle of a line, they must be followed by two 
blanks for vi to recognize them. You should get used to the vi convention of 
recognizing two blanks after a period as the end of a sentence, because it is often 
useful to be able to operate on a sentence as a unit. 


You can move the cursor from sentence to sentence in the file with the < (> 
(open parenthesis) and <)> (close parenthesis) commands. 


< (> Move the cursor to the beginning of the current sentence. 


< n( >Move the cursor to the beginning of the nth sentence above the 
current sentence. 


<)> Move the cursor to the beginning of the next sentence. 
< n) >Move the cursor to the beginning of the nth sentence below the 


current sentence. 


The example in the following screens shows how the open parenthesis moves 
the cursor around the screen. 
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Suddenly we spotted whales in the 
distance. Daniel was the first to see them. 


distance. Daniel was the first to see them. 


Now repeat the command, preceding it with a number. 


<3(> (or) 
<5)> 


Did the cursor move the correct number of sentences? 
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Positioning the Cursor by Paragraphs 


Paragraphs are recognized by vi if they begin after a blank line. If you want 
to be able to move the cursor to the beginning of a paragraph (or later in this 
tutorial, to delete or change a whole paragraph), then make sure each paragraph 
ends in a blank line. 


<{> Move the cursor to the beginning of the current paragraph, 
which is delimited by a blank line above it. 

<n{> Move the cursor to the beginning of the nth paragraph above 
the current paragraph. 

<}> Move the cursor to the beginning of the next paragraph. 

<n}> Move the cursor to the mth paragraph below the current line. 


The following two screens show how the cursor can be moved to the beginning 
of another paragraph. 


Suddenly, we spotted whales in the 
distance. Daniel was the first to see them. 


<}> 
"Hey look! Here come the whales!" he cried excitedly. 
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Suddenly, we spotted whales in the 


distance. Daniel was the first to see them. 


fpr 
"Hey look! Here come the whales!" he cried excitedly. 


Positioning in the Window 


The vi editor also provides three commands that help you position yourself in 
the window. Try out each command. Be sure to type them in upper case. 


<H> Move the cursor to the first line on the screen. 
<M> Move the cursor to the middle line on the screen. 
<L> Move the cursor to the last line on the screen. 
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This part of the file is 
above the display window. 


Type <H> (HOME) to move the cursor here. 


Type <M> (MIDDLE) to move the cursor here. 


Type <L> (LAST line on screen) to move 
the cursor here. 


This part of the file is 
below the display window. 


Figures 6-3 through 6-6 summarize the vi commands for moving the cursor 
by positioning it on a character, line, word, sentence, paragraph, or position on the 


screen. (Additional vi commands for moving the cursor are summarized in Figure 
6-7, later in the chapter.) 
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Positioning on a Character 


Move the cursor one character to the left. 
<I> Move the cursor one character to the right. 
<BACKSPACE> | Move the cursor one character to the left. 
<space bar> Move the cursor one character to the right. 


<fx> Move the cursor to the right to the specified char- 
acter x. 


<Fx> Move the cursor to the left to the specified char- 
acter x. 


Move the cursor to the right, to the character just 
before the specified character x. 


Move the cursor to the left, to the character just 
after the specified character x. 


Continue searching in same direction on the line 
for the last character requested with <f>, <F>, 
<t>,or <T>. The ; remembers the character 
and finds the next occurrence of it on the current — 
line. 


Continue searching in opposite direction on the 
line for the last character requested with <f>, 
<F>, <t>,or <T>. The , remembers the 
character and finds the next occurrence of it on 
the current line. 


Figure 6-3: Summary of vi Motion Commands (Sheet 1 of 4) 
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Positioning on a Line 


Move the cursor up to the same column in the previ- 
ous line (if a character exists in that column). 


Move the cursor down to the same column in the next 
line (if a character exists in that column). 


Move the cursor up to the beginning of the previous 
line. 


Move the cursor down to the beginning of the next 
line. 


Move the cursor down to the beginning of the next 
line. 


Figure 6-4: Summary of vi Motion Commands (Sheet 2 of 4) 
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Positioning on a Word 


Move the cursor forward to the first character in the 
next word. 


Ignore all punctuation and move the cursor forward to 
the next word delimited only by blanks. 


Move the cursor backward one word to the first char- 
acter of that word. 


Move the cursor to the left one word, which is delim- 
ited only by blanks. 


Move the cursor to the end of the current word. 


Delimit the words by blanks only. The cursor is 
placed on the last character before the next blank 
space, or end of the line. 


Figure 6-5: Summary of vi Motion Commands (Sheet 3 of 4) 
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Positioning on a Sentence 


<(> Move the cursor to the beginning of the current sen- 
tence. 


<)> Move the cursor to the beginning of the next sentence. 


Positioning on a Paragraph 


Move the cursor to the beginning of the current para- 
graph. 


Move the cursor to the beginning of the next para- 
graph. 


Positioning in the Window 


<H> Move the cursor to the first line on the screen (the 
home position). 


Move the cursor to the middle line on the screen. 
Move the cursor to the last line on the screen. 


Figure 6-6: Summary of vi Motion Commands (Sheet 4 of 4) 
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How do you move the cursor to text that is not shown in the current editing 
window? One option is to use the <20j> or <20k> command. However, if you 
are editing a large file, you need to move quickly and accurately to another place 
in the file. This section covers those commands that can help you move around 
within the file in the following ways: 


@ by scrolling forward or backward in the file 
m@ by going to a specified line in the file 


™ by searching for a pattern in the file 


Scrolling the Text 


Four commands allow you to scroll the text of a file. The <“f> (control-f) 
and <“d> (control-d) commands scroll the screen forward. The <“b> 
(control-b) and <“u> (control-u) commands scroll the screen backward. 


The Control-f Command. 


The <“f> (control-f) command scrolls the text forward one full window of 
text below the current window. To do this vi clears the screen and redraws the 
window. The three lines that were at the bottom of the current window are 
placed at the top of the new window. If there are not enough lines left in the file 
to fill the window, the screen displays a ~ (tilde) to show that there are empty 
lines. 


vi clears and redraws the screen as follows: 
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These last three lines of the current 
window become the first two lines of 
the new window. 


This part of the file 
is below the display 
window. 


You can scroll forward 
to place this text in the 
display window. 


The Control-d Command 


The <“d> (control-d) command scrolls down a half screen to reveal text 
below the window. When you type <“d>, the text appears to be rolled up at the 
top and unrolled at the bottom. This allows the lines below the screen to appear 
on the screen, while the lines at the top of the screen cisappeal: If there are not 
enough lines in the file, a bell will sound. 


The Control-b Command 


The <“b> (control-b) command scrolls the screen back a full window to 
reveal the text above the current window. To do this, vi clears the screen and 
redraws the window with the text that is above the current screen. Unlike the 
<“f> command, <“b> does not leave any reference lines from the previous win- 
dow. If there-are not enough lines above the current window to fill a full new 
window, a bell will sound and the current window will remain on the screen. 
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Any text in this display window 
will be placed below the current 
window. 

The current window clears and is re- 
drawn with the text above the window. 


This part of the file 
is above the display 
window. 


You can scroll backward 
to place this text in the 
display window. 


Now try scrolling backward. Type 


<“b> 


vi clears the screen and draws a new screen. 


280 


USER’S GUIDE 


Positioning the Cursor in Undisplayed Text 


This part of the file 
is above the display window. 


You can scroll backward 
to place this text in the 
display window. 


Any text in this display window 
will be placed below the current 
window. 

The current window clears and is 
redrawn with the text above the 
window. 


Any text that was in the display window is placed below the current window. 


The Control-u Command 


The <*u> (control-u) command scrolls up a half screen of text to reveal the 
lines just above the window. The lines at the bottom of the window are erased. 
Now scroll down in the text, moving the portion below the screen into the window. 
Type: 


<*u> 
When the cursor reaches the top of the file, a bell sounds to notify you that the 
file cannot scroll further. 


Go to a Specified Line 


The <G> command positions the cursor on a specified line in the window; if 
that line is not currently on the screen, <G> clears the screen and redraws the 
window around it. If you do not specify a line, <G> goes to the last line of the 
file. 
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<G> go to the last line of the file 
<nG> go to the nth line of the file 


Line Numbers 


Each line of the file has a line number corresponding to its position in the 
buffer. To get the number of a particular line, position the cursor on it and type 
<“g>. The <“g> command gives you a status notice at the bottom of the 
screen which tells you: 


282 


the name of the file 

if the file has been modified 

the line number on which the cursor rests 
the total number of lines in the buffer 


the percentage of the total lines in the buffer represented by the current 
line 


This line is the 35th line of the buffer. 
The cursor is on this line. 


: 


<“g> 


There are several more lines in the 
buffer. 
The last line of the buffer is line 116. 
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This line is the 35th line of the buffer. 
The cursor is on this line. 


There are several more lines in the 
buffer. 
The last line of the buffer is line 116. 


"file.name" [modified] line 36 of 116 --34%-- 


Searching for a Pattern of Characters: the / and ? 
Commands 


The fastest way to reach a specific place in your text is by using one of the 
search commands: /, ?, <n>,or <N>. These commands allow you to search 
forward or backward in the buffer for the next occurrence of a specified character 
pattern. The / and ? commands are not silent; they appear as you type them, 
along with the search pattern, on the bottom of the screen. The <n> and <N> 
commands, which allow you to repeat the requests you made for a search with a / 
or ? command, are silent. 


The /, followed by a pattern (/pattern), searches forward in the buffer for the 
next occurrence of the characters in pattern, and puts the cursor on the first of 
those characters. For example, the command line 


/Helle world<CR> 


finds the next occurrence in the buffer of the words Hello world and puts the cur- 
sor under the H. 


The ?, followed by a pattern (2pattern), searches backward in the buffer for 
the first occurrence of the characters in pattern, and puts the cursor on the first of 
those characters. For example, the command line 


?data set design<CR> 
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finds the last occurrence in the buffer (before your current position) of the words 
data set design and puts the cursor under the d in data. 


These search commands do not wrap around the end of a line while searching 
for two words. For example, say you are searching for the words Hello world. 
If Hello is at the end of one line and world is at the beginning of the next, the 
search command will not find that occurrence of Hello World. 


However, they do wrap around the end or the beginning of the buffer to con- 
tinue a search. For example, if you are near the end of the buffer, and the pat- 
tern for which you are searching (with the /pattern command) is at the top of the 
buffer, the command will find the pattern. 


The <n> and <N> commands allow you to continue searches you have | 
requested with /pattern or ?pattern without retyping them. 


<n> _ Repeat the last search command. 


<N> Repeat the last search command in the opposite direction. 


For example, say you want to search backward in the file for the three-letter pat- 
tern the. Initiate the search with ?the and continue it with <n>. The following 
screens offer a step-by-step illustration of how the <n> searches backward 
through the file and finds four occurrences of the character string the. 


Suddenly, we spotted whales in the 
distance. Daniel was the first to see them. 


"Hey look! Here come the whales!" he cried excitedly. 
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Suddenly, we spotted whales in the 

distance. Daniel was the first to see them. 

~P 

"Hey look! Here come the whales!" he cried excitedly. 


(1) 


Suddenly, we spotted whales in the 
distance. Daniel was the first to see them. 


"Hey look! Here come the whales!" he cried excitedly. 


| 
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Suddenly, we spotted whales in the 
distance. Daniel was the first to see then. 


(2) 


"Hey look! Here come the whales!" he cried excitedly. 


Suddenly, we spotted whales in the 
distance. Daniel was the first to see them. 


<n> 


"Hey look! Here come the whales!" he cried excitedly. 
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Suddenly, we spotted whales in the 
distance. Daniel was the first to see them. 


| 


(3) 


"Hey look! Here come the whales!" he cried excitedly. 


Suddenly, we spotted whales in the 
distance. Daniel was the first to see then. 


<n> 
ee 
"Hey look! Here come the whales!" he cried excitedly. 
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Suddenly, we spotted whales in the 


(4) 
distance. Daniel was the first to see them. 
Pa sg 
"Hey look! Here come the whales!" he cried excitedly. 


The / and ? search commands do not allow you to specify particular 
occurrences of a pattern with numbers. You cannot, for example, request the 
third occurrence (after your current position) of a pattern. 


Figure 6-7 summarizes the vi commands for moving the cursor by scrolling 
the text, specifying a line number, and searching for a pattern. 
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Positioning the Cursor in Undisplayed Text 


Scrolling 


Scroll the screen forward a full window, revealing the win- 
dow of text below the current window. 


Scroll the screen down a half window, revealing lines 
below the current window. 


Scroll the screen back a full window, revealing the window 
of text above the current window. 


Scroll the screen up a half window, revealing the lines of 
text above the current window. 


Positioning on a Numbered Line 


Go to the first line of the file. 
Go to the last line of the file. 


Give the line number and file status. 


Searching for a Pattern 


/pattern | Search forward in the buffer for the next occurrence of 
the pattern. Position the cursor on the first character of 
the pattern. 


?pattern | Search backward in the buffer for the first occurrence of 
the pattern. Position the cursor under the first character 
of the pattern. 


Repeat the last search command. 


Repeat the search command in the opposite direction. 


Figure 6-7: Summary of Additional vi Motion Commands 
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Exercise 2 


2-1. Create a file called exer2. Type a number on each line, numbering the 
lines from 1 to 50. Your file should look similar to the following. 


2-2. Try using each of the scroll commands, noticing how many lines scroll 
through the window. Try the following: 
<“f> 
<“b> 
<“u> 
<“d> 
2-3. Go to the end of the file. Append the following line of text. 
123456789 123456789 
What number does the command <7h> place the cursor on? What 
number does the command <3I> place the cursor on? 
2-4. Try the command <$> and the command <0> (number zero). 


2-5, Go to the first character on the line that is not a blank. Move to the first 
character in the next word. Move back to the first character of the word 
to the left. Move to the end of the word. 
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2-1. 


Exercise 2 


Go to the first line of the file. Try the commands that place the cursor in 
the middle of the window, on the last line of the window, and on the first 
line of the window. 


Search for the number 8. Find the next occurrence of the number 8. 
Find 48. 
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Creating Text 


There are three basic commands for creating text: 
<a> append text 

<i> insert text 

<o> open a new line on which text can be entered 


After you finish creating text with any one of these commands, you can 
return to the command mode of vi by pressing the ESCAPE key. 


Appending Text 


<a> append text after the cursor 

<A> append text at the end of the current line 

You have already experimented with the <a> command in the "Creating a 
File" section. Make a new file named junk2. Append some text using the <a> 


command. To return to command mode of vi, press the ESCAPE key. Then 
compare the <a> command to the <A> command. 


Inserting Text 


<i> insert text before the cursor 


<I> __ insert text at the beginning of the current line before the first charac- 
ter that is not a blank 


To return to the command mode of vi, press the ESCAPE key. 


In the following examples you can compare the append and insert commands. 
The arrows show the position of the cursor, where new text will be added. 
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Creating Text 


Append three spaces AFTER the H of Here 


Insert three spaces BEFORE the H of Here. 


<i>. 


Insert three spaces BEFORE the H of 


Notice that in both cases, the user has left text input mode by pressing the 
ESCAPE key. 
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Opening a Line for Text 


<o> Create text from the beginning of a new line below the current line. 
You can issue this command from any point in the current line. 


<O> Create text from the beginning of a new line above the current line. 
This command can also be issued from any position in the current 
line. 


The open command creates a directly above or below the current line, and 
puts you into text input mode. For example, in the following screens the <O> 
command opens a line above the current line, and the <o> command opens a 
line below the current line. In both cases, the cursor waits for you to enter text 
from the beginning of the new line. — 


Create text ABOVE the current line. 


[blank line] 
Create text ABOVE the current line. 
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Creating Text 


Now create text BELOW the current line. 


<o> 


Now create text BELOW the current line. 
[blank line] 


Figure 6-8 summarizes the commands for creating and adding text with the vi 
editor. 
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Creating Text 


Create text after the cursor. 


Create text at the end of the current line. 


Create text in front of the cursor. 


Create text before the first character on 
the current line that is not a blank. 


line below the current line. 


line above the current line. 


of the above text input modes. 


Figure 6-8: Summary of vi Commands for Creating Text 
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Create text at the beginning of a new 


Create text at the beginning of a new 


Return vi to command mode from any 


Exercise 3 


3-1. 
3-2. 


3-4. 


3-5. 


3-6. 


3-7. 


3-8. 


Create a text file called exer3. 


Insert the following four lines of text. 


Append text 

Insert text 

a computer’s 
job is boring. 


Add the following line of text above the last line: 


financial statement and 


je 


Using a text insert command, add the following line of text above the 
third line: 


4, 
% 


Delete text 


Add the following line of text below the current line: 


byte of the budget ae 


Using an append command, add the following line of text below the last 
line: a i oy é 


But, it is an exciting machine. 


Move to the first line and add the word some before the word text. 


Now practice using each of the six commands for creating text. 


Leave vi and go on to the next section to find out how to delete any mis- 


takes you made in creating text. i 
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Deleting Text 


You can delete text with various commands in command mode, and undo the 
entry of small amounts of text in text input mode. In addition, you can undo 
entirely the effects of your most recent command. 


Undoing Entered Text in Text Input Mode 

To delete a character at a time when you are in text input mode use the 
BACKSPACE key. 

<BACKSPACE> Delete the current character (the character shown by the 


cursor). 


The BACKSPACE key backs up the cursor in text input mode and deletes 
each character that the cursor backs across. However, the deleted characters are 
not erased from the screen until you type over them or press the ESCAPE key to 
return to command mode. 


In the following example, the arrows represent the cursor. 


Mary had a litttl 


<BACKSPACE> <BACKSPACE> 


Mary had a litttl 


<ESC> 


Mary had a litt 
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Notice that the characters are not erased from the screen until you press the 
ESCAPE key. 


There are two other keys that delete text in text input mode. Although you 
may not use them often, you should be aware that they are available. To remove 
the special meanings of these keys so that they can be typed as text, see the sec- 
tion on special commands. 


<“w> undo the entry of the current word 


<@> _ delete all text entered on current line since text input mode was 
entered 


When you type <“w>, the cursor backs up over the word last typed and 
waits on the first character. It does not literally erase the word until you press 
the ESCAPE key or enter new characters over the old ones. The <@> sign 
behaves in a similar manner except that it removes all text you have typed on the 
current line since you last entered input mode. 


Undo the Last Command 


Before you experiment with the delete commands, you should try the u com- 
mand. This command undoes the last command you issued. 


<u> _ undo the last command 


<U> restore the current line to its state before you changed it 


If you delete lines by mistake, type <u>; your lines will reappear on the 
screen. If you type the wrong command, type <u> and it will be nullified. The 
<U> command will nullify all changes made to the current line as long as the 
cursor has not been moved from it. 


If you type <u> twice in a row, the second command will undo the first; 
your undo will be undone! For example, say you delete a line by mistake and 
restore it by typing <u>. Typing <u> a second time will delete the line again. 
Knowing this command can save you a lot of trouble. 
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Deleting Text 


Delete Commands in Command Mode 


You know that you can precede a command by a number. Many of the com- 
mands in vi, such as the delete and change commands, also allow you to enter a 
cursor movement command after another command. The cursor movement com- 
mand can specify a text object such as a word, line, sentence, or paragraph. The 
general format of a vi command is: 


[number][command]text_object 


The brackets around some components of the command format show that those 
components are optional. 


All delete commands issued in command mode immediately remove unwanted 
text from the screen and redraw the affected part of the screen. 


The delete command follows the general format of a vi command. 


[number]dtext_object 


Deleting Words 


You can delete a word or part of a word with the <dw> command. Move 
the cursor to the first character to be deleted and type <dw>. The character 
under the cursor and all subsequent characters in that word will be erased. 


the deep dark depths of the lake. 
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Deleting Text 


the depths of the lake. 


| 


The <dw> command deletes one word or punctuation mark and the space(s) 
that follow it. You can delete several words or marks at once by specifying a 
number before the command. For example, to delete three words and two com- 
mas, type <5dw>. 


the deep, deep, dark depths of the lake 
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Deleting Text 


the depths of the lake 


Deleting Paragraphs 


To delete paragraphs, use the following commands. 
<d{> or <d}> 
Observe what happens to your file. Remember, you can restore the deleted text 


with <u>. 


Deleting Lines 


To delete a line, type <dd>. To delete multiple lines, specify a number 
before the command. For example, typing 


<10dd> 


will erase ten lines. If you delete more than a few lines, vi will display this notice 
on the bottom of the screen: 


10 lines deleted 


If there are less than ten lines below the current line in the file, a bell will sound 
and no lines will be deleted. 
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Deleting Text After the Cursor 


To delete all text on a line after the cursor, put the cursor on the first charac- 
ter to be deleted and type 


<D> or <d$>. 
Neither of these commands allows you to specify a number of lines; they can be 


used only on the current line. 


Figure 6-9 summarizes the vi commands for deleting text. 
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For INSERT Mode: 
<BACKSPACE> Delete the current character. 
<*h> Delete the current character. 
<“W> Delete the current word. 


<@> Delete the current line of new text or 
delete all new text on the current line. 


For COMMAND Mode: 
<u> Undo the last command. 
<U> Restore current line to its previous state. 


<x> Delete the current character. 


<ndx> Delete n number of text objects of type x. 


<dw> Delete the word at the cursor through the 
next space or to the next punctuation 
mark. 


Delete the word and punctuation at the 
cursor through the next space. 


Delete the current line. 


Delete the portion of the line to the right 
of the cursor. 


Delete the current sentence. 


Delete the current paragraph. 


Figure 6-9: Summary of Delete Commands 
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Exercise 4 


4-1. Create a file called exer4 and put the following four lines of text in it: 
When in the course of human events 
there are many repetitive, boring 


chores, then one ought to get a 
robot to perform those chores. 


4-2. Move the cursor to line two and append to the end of that line: 
tedious and unsavory. es is “oS 
Delete the word unsavory while you are in append mode. iad = 
Delete the word boring while you are in command mode. ~~ on ae 


What is another way you could have deleted the word boring? 


4-3. Insert at the beginning of line four: 
congenial and computerized. 
Delete the line. 


How can you delete the contents of the line without removing the line 
itself? 


Delete all the lines with one command. 


4-4. Leave the screen editor and remove the empty file from your directory. 
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The delete commands and text input commands provide one way for you to 
modify text. Another way you can change text is by using a command that lets 
you delete and create text simultaneously. There are three basic change com- 
mands: <r>, <s>, and <c>. 


Replacing Text 


<r> Replace the current character (the character shown by the cursor). 
This command does not initiate text input mode, and so does not 
need to be followed by pressing the ESCAPE key. 


<nr> Replace n characters with the same letter. This command automati- 
cally terminates after the nth character is replaced. It does not need 
to be followed by pressing the ESCAPE key. 


<R> _ Replace only those characters typed over until the ESCAPE com- 
mand is given. If the end of the line is reached, this command will 
append the input as new text. 


The <r> command replaces the current character with the next character 
that is typed in. For example, suppose you want to change the word acts to ants 
in the following sentence: 


The circus has many acts. 
Place the cursor under the c of acts and type 
<r>n 
The sentence becomes 
The circus has many ants. 
To change many to 7777, place the cursor under the mof many and type 
<4r7> 


The <r> command changes the four letters of many to four occurrences of the 
number seven. 


The circus has 7777 ants. 
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Substituting Text 


The substitute command replaces characters, but then allows you to continue 
to insert text from that point until you press the ESCAPE key. 


<s> Delete the character shown by the cursor and append text. End the 
text input mode by pressing the ESCAPE key. 


<ns> Delete n characters and append text. End the text input mode by 
pressing the ESCAPE key. 


<S> _ Replace all the characters in the line. 


When you enter the <s> command, the last character in the string of char- 
acters to be replaced is overwritten by a $ sign. The characters are not erased 
from the screen until you type over them, or leave text input mode by pressing the 
ESCAPE key. 


Notice that you cannot use an argument with either <r> or <s>. Did you 
try? 


Suppose you want to substitute the word million for the word hundred in the 
sentence My salary is one hundred dollars. Put the cursor under the h of 
hundred and type <7s>. Notice where the $ sign appears. 


My salary is one hundred dollars. 


Then type million. 
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My salary is one hundre$ dollars. 


million 


My salary is one million dollars. 


Changing Text 


The substitute command replaces characters. The change command replaces 
text objects, and then continues to append text from that point until you press the 
ESCAPE key. To end the change command, press the ESCAPE key. 


The change command can take an argument. You can replace a character, 
word, or an entire line with new text. 


<ncex> Replace m number of text objects of type x, such as sentences 
(shown by <)>) and paragraphs (shown by <}>). 
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<cw> 


<ncw> 
<cc> 
<ncce> 


<C> 


<nC> 


Modifying Text 


Replace a word or the remaining characters in a word with new 
text. The vi editor prints a $ sign to show the last character to 
be changed. 


Replace n words. 
Replace all the characters in the line. 


Replace all characters in the current line and up to z lines of 
text. 


Replace the remaining characters in the line, from the cursor to 
the end of the line. 


Replace the remaining characters from the cursor in the current 
line and replace all the lines following the current line up to n 
lines. 


The change commands, <cew> and <C>, use a $ sign to mark the last 
letter to be replaced. Notice how this works in the following example: 


They are now due to arrive on Tuesday. 
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They are now due to arrive on Tuesda$. 


Wednesday < ESC> 


They are now due to arrive on Wednesday. 


Notice that the new word (Wednesday) has more letters than the word it replaced 
(Tuesday). Once you have executed the change command you are in text input 
mode and can enter as much text as you want. The buffer will accept text until 
you press the ESCAPE key. 


The <C> command, when used to change the remaining text on a line, 
works in the same way. When you enter the command it uses a $ sign to mark 
the end of the text that will be deleted, puts you in text input mode, and waits for 
you to type new text over the old. The following screens offer an example of the 
C command. 
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This is line 1. 
Oh, I must have the wrong number. 


| 


<C> 
This is line 3. 
This is line 4. 


This is line 1. 
Oh, I must have the wrong number$ 


This is line 2.<ESC> 
This is line 3. 
This is line 4. 


This is line 1. 
This is line 2. 
This is line 3. 
This is line 4. 
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Now try combining arguments. For example, type 
<c{> | 


Because you know the undo command, do not hesitate to experiment with dif- 
ferent arguments or to precede the command with a number. You must press the 
ESCAPE key before using the <u> command, since <e> places you in text 
input mode. 


Compare <S> and <cc>. The two commands should produce the same 
results. 


Figure 6-10 summarizes the vi commands for changing text. 
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Replace the current character. 


Replace only those characters typed over with 
new characters until the ESCAPE key is pressed. 


Delete the character the cursor is on and append 
text. End the append mode by pressing the 
ESCAPE key. 


Replace all the characters in the line. 
Replace all the characters in the line. 


Replace n number of text objects of type x, such 
as sentences (shown by <)>) and paragraphs 
(shown by <}>). 

Replace a word or the remaining characters in a 
word with new text. 


Replace the remaining characters in the line, 
from the cursor to the end of the line. 


Figure 6-10: Summary of vi Commands for Changing Text 
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Cutting And Pasting Text Electronically 


vi provides a set of commands that cut and paste text in a file. Another set of 
commands copies a portion of text and places it in another section of a file. 


Moving Text 


You can move text from one place to another in the vi buffer by deleting the 
lines and then placing them at the required point. The last text that was deleted 
is stored in a temporary buffer. If you move the cursor to that part of the file 
where you want the deleted lines to be placed and press the p key, the deleted 
lines will be added below the current line. 


<p> Place the contents of the temporary buffer after the cursor. 


A partial sentence that was deleted by the <D> command can be placed in 
the middle of another line. Position the cursor in the space between two words, 
then press <p>. The partial line is placed after the cursor. 


Characters deleted by <nx> also go into a temporary buffer. Any text 
object that was just deleted can be placed somewhere else in the text with <p>. 


The <p> command should be used right after a delete command since the 
temporary buffer only stores the results of one command at a time. The <p> 
command is also used to copy text placed in the temporary buffer by the yank 
command. The yank command (<y>) is discussed in "Copying Text." 


Fixing Transposed Letters 
A quick way to fix transposed letters is to combine the <x> and the <p> 


commands as <xp>. <x> deletes the letter. <p> places it after next charac- 
ter. 
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Cutting And Pasting Text Electronically 


Notice the error in the next line. 


A line of tetx 


This error can be changed quickly by placing the cursor under the t in tx and 
then pressing the <x> and <p> keys, in that order. The result is: 


A line of text 


Try this. Make a typing error in your file and use the <xp> command to 
correct it. Why does this command work? 


Copying Text 


You can yank (copy) one or more lines of text into a temporary buffer, and 
then put a copy of that text anywhere in the file. To put the text in a new posi- 
tion type <p>; the text will appear on the next line. 


The yank command follows the general format of a vi command. 


[numberlyltext_object] 


Yanking lines of text does not delete them from their original position in the file. 
If you want the same text to appear in more than one place, this provides a con- 
venient way to avoid typing the same text several times. However, if you do not 
want the same text in multiple places, be sure to delete the original text after you 
have put the text into its new position. 


Figure 6-11 summarizes the ways you can use the yank command. 
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Yank n number of text objects of type x, (such as 
sentences ) and paragraphs }). 


Yank a copy of a word. 
Yank a copy of the current line. 


Yank n lines. 


Yank all text up to the end of a sentence. 


Yank all text up to the end of the paragraph. 


Figure 6-11: Summary of the Yank Command 


Notice that this command allows you to specify the number of text objects to be 
yanked. 


Try the following command lines and see what happens on your screen. 
(Remember, you can always undo your last command.) Type: 


<S5yw> 
Move the cursor to another spot. Type: 


<p> 


Now try yanking a paragraph <y}> and placing it after the current paragraph. 
Then move to the end of the file <G> and place that same paragraph at the end 
of the file. 
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Copying or Moving Text Using Registers 


Moving or copying several sections of text to a different part of the file is 
tedious work. vi provides a shortcut for this: named registers in which you can 
store text until you want to move it. To store text you can either yank or delete 
the text you wish to store. 


Using registers is useful if a piece of text must appear in many places in the 
file. The extracted text stays in the specified register until you either end the 
editing session, or yank or delete another section of text to that register. 


The general format of the command is: 
[number]|"x]commandl| text_object] 


The x is the name of the register and can be any single letter. It must be pre- 
ceded by a double quotation mark. For example, place the cursor at the begin- 
ning of a line. Type: 


<3"ayy> 

Type in more text and then go to the end of the file. Type: 
<"ap> 

Did the lines you saved in register a appear at the end of the file? 


Figure 6-12 summarizes the cut and paste commands. 
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Place the contents of the temporary buffer con- 
taining the text obtained from the most recent 

delete or yank command into the text after the 
cursor. 


Yank a line of text and place it into a temporary 
buffer. 


Yank a copy of m number of text objects of type x 
and place them in a temporary buffer. 


Place a copy of a text object of type n in the 
register named by the letter x. 


Place the contents of the register x after the cur- 
sor. 


Figure 6-12: Summary of vi Commands for Cutting and Pasting Text 
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Exercise 5 


5-1. Enter vi with the file called exer2. that you created in Exercise 2. 


Go to line eight and change its contents to END OF FILE 


5-2. Yank the first eight lines of the file and place them in register z. Put the 
contents of register z after the last line of the file. 


5-3. Go to line eight and change its contents to eight is great 
5-4. Go to the last line of the file. Substitute EXERCISE for FILE Replace 
OF with TO 
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Here are some special commands that you will find useful. 
<.> repeat the last command 
<J> join two lines together 
<*“I> clear the screen and redraw it 


<~> change lower case to upper case and vice versa 


Repeating the Last Command 


The . period repeats the last command to create, delete, or change text in the 
file. It is often used with the search command. 


For example, suppose you forget to capitalize the S in United States. How- 
ever, you do not want to capitalize the s in chemical states. One way to correct 
this problem is by searching for the word states. The first time you find it in the 
expression United States, you can change the s to S. Then continue your search. 
When you find another occurrence, you can simply type a period; vi will 
remember your last command and repeat the substitution of s for S. 


Experiment with this command. For example, if you try to add a period at 
the end of a sentence while in command mode, the last text change will suddenly 
appear on the screen. Watch the screen to see how the text is affected. 


Joining Two Lines 


The <J> command joins lines. To enter this command, place the cursor on 
the current line, and press the SHIFT and j keys simultaneously. The current 
line is joined with the following line. 


For example, suppose you have the following two lines of text: 


Dear Mr. 
Smith: 
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To join these two lines into one, place the cursor under any character in the first 
line and type: 


<J> 
You will immediately see the following on your screen: 
Dear Mr. Smith: 


Notice that vi automatically places a space between the last word on the first line 
and the first word on the second line. 


Clearing and Redrawing the Window 


If another UNIX system user sends you a message using the write command 
while you are editing with vi, the message will appear in your current window, 
over part of the text you are editing. To restore your text after you have read the 
message, you must be in command mode. (If you are in text input mode, press 
the ESCAPE key to return to command mode.) Then type <“I> (control-l). vi 
will erase the message and redraw the window exactly as it appeared before the 
message arrived. 


Changing Lower Case to Upper Case and Vice Versa 


A quick way to change any lower case letter to upper case, or vice versa, is by 
putting the cursor on the letter to be changed and typing a <~> (tilde). For 
example, to change the letter a to A, press ~. You can change several letters by 
typing ~ several times, but you cannot precede the command with a number to 
change several letters with one command. 


Figure 6-13 summarizes the special commands. 
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Repeat the last command. 
Join the line below the current line with the current line. 


Clear and redraw the current window. 


Change lower case to upper case, or vice versa. 


Figure 6-13: Summary of Special Commands 
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Using Line Editing Commands in Vi 


The vi editor has access to many of the commands provided by a line editor 
called ex. (For a complete list of ex commands see the ex(1) page in the User’s 
Reference Manual.) This section discusses some of those most commonly used. 


The ex commands are very similar to the ed commands discussed in 
Chapter 5. If you are familiar with ed, you may want to experiment on a test file 
to see how many ed commands also work in vi. 


Line editor commands begin with a: (colon). After the colon is typed, the 
cursor will drop to the bottom of the screen and display the colon. The remainder 
of the command will also appear at the bottom of the screen as you type it. 


Temporarily Returning to the Shell: the :sh and :! 
Commands 


When you enter vi, the contents of the buffer fill your screen, making it 
impossible to issue any shell commands. However, you may want to do so. For 
example, you may want to get information from another file to incorporate into 
your current text. You could get that information by running one of the shell 
commands that display the text of a file on your screen, such as the cat or pg 
command. However, quitting and reentering the editor is time consuming and 
tedious. vi offers two methods of escaping the editor temporarily so that you can 
issue shell commands (and even edit other files) without having to write your 
buffer and quit: the :! command and the :sh command. 


The :! command allows you to escape the editor and run a shell command on 
a single command line. From the command mode of vi, type :!. These characters 
will be printed at the bottom of your screen. Type a shell command immediately 
after the !. The shell will run your command, give you output, and print the mes- 
sage [Hit return to continue]. When you press the RETURN key vi will 
refresh the screen and the cursor will reappear exactly where you left it. 
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The ex command :sh allows you to do the same thing, but behaves differently 
on the screen. From the command mode of vi type :sh and press the RETURN 
key. A shell command prompt will appear on the next line. Type your 
command(s) after the prompt as you would normally do while working in the: 
shell. When you are ready to return to vi, type <“d> or exit; your screen will be 
refreshed with your buffer contents and the cursor will appear where you left it. 


Even changing directories while you are temporarily in the shell will not 
prevent you from returning to the vi buffer where you were editing your file when 
you type exit or <“d>. 


Writing Text to a New File: the :w Command 


The :w (for write) command allows you to create a file by copying lines of 
text from the file your are currently editing into a file that you specify. To create 
your new file you must specify a line or range of lines (with their line numbers), 
along with the name of the new file, on the command line. You can write as 
many lines as you like. The general format is: 


sline_number[line_numberlw filename 


For example, to write the third line of the buffer to a line named three, type: 
:3w three<CR> 
vi reports the successful creation of your new file with the following information: 
"three" [New file] 1 line, 20 characters 
To write your current line to a file, you can use a. (period) as the line 
address: 
Ww junk<CR> 


A new file called junk will be created. It will contain only the current line in the 
vi buffer. 
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You can also write a whole section of the buffer to a new file by specifying a 


range of lines. For example, to write lines 23 through 37 to a file, type the fol- 
lowing: 


:23,37w newfile<CR> 


Finding the Line Number 


To determine the line number of a line, move the cursor to it and type : 
(colon). The colon will appear at the bottom of the screen. Type .= after it 
and press the RETURN key. 


If you want to know the number 
of this line, type :.=<CR> 


As soon as you press the RETURN key, your command line will disappear from 
the bottom line and be replaced by the number of your current line in the buffer. 
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If you want to know the number 
of this line, type in :.=<CR> 


You can move the cursor to any line in the buffer by typing : and the line 
number. The command line 


n<CR> 


means to go to the nth line of the buffer. 


Deleting the Rest of the Buffer 


One of the easiest ways to delete all the lines between the current line and the 
end of the buffer is by using the line editor command d with the special symbols 
for the current and last lines. 


2.90 <CR> 


The . represents the current line; the $ sign, the last line. 


Adding a File to the Buffer 


To add text from a file below a specific line in the editing buffer, use the :r 
(read) command. For example, to put the contents of a file called data into your 
current file, place the cursor on the line above the place where you want it to 
appear. Type: 


rr data<CR> 


You may also specify the line number instead of moving the cursor. For example, 
to insert the file data below line 56 of the buffer, type 
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:56r data<CR> 


Do not be afraid to experiment; you can use the <u> command to undo ex com- 
mands, too. 


Making Global Changes 


One of the most powerful commands in ex is the global command. The glo- 
bal command is given here to help those users who are familiar with the line edi- 
tor. Even if you are not familiar with a line editor, you may want to try the com- 
mand on a test file. 


For example, say you have several pages of text about the DNA molecule in 
which you refer to its structure as a helix. Now you want to change every 
occurrence of the word helix to double helix. The ex editor’s global command 
allows you to do this with one command line. First, you need to understand a 
series of commands. 


:g/pattern/command <CR> 


For each line containing pattern, execute the ex command named 
command. For example, type: :g/helix<CR>. The line editor will 
print all lines that contain the pattern helix. 


:s/pattern/new_words/<CR> 


This is the substitute command. The line editor searches for the first 
instance of the characters pattern on the current line and changes 
them to new_words. 


:s/pattern/new_words/g<CR> 
If you add the letter g after the last delimiter of this command line, 


ex will change every occurrence of pattern on the current line. If you 
do not, ex will change only the first occurrence. 


:g/helix/s//double helix/g<CR> 
This command line searches for the word helix. Each time helix is 


found, the substitute command substitutes two words, double helix, 
for every instance of helix on that line. The delimiters after the s do 
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not need to have helix typed in again. The command remembers the 
word from the delimiters after the global command g. This is a 
powerful command. For a more detailed explanation of global and 
substitution commands, see Chapter 5. 


Figure 6-14 summarizes the line editor commands available in vi. 
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Shows that the commands that follow are 
line editor commands. 


ssh<CR> Temporarily returns you to the shell to 
perform shell commands. 


<“d> Escapes the temporary shell and returns 
you to the current window of vi to con- 
tinue editing. 


n<CR> Goes to the nth line of the buffer. 


xx,yw data<CR> Writes lines from the number x through 
the number y into a new file (data). 


:3$<CR> Goes to the last line of the buffer. 


:..90 <CR> Deletes all the lines in the buffer from 
the current line to the last line. 


x shell file<CR> Inserts the contents of shell file after the 
current line of the buffer. 


:s/text/new_words/<CR> _ {Replaces the first instance of the charac- 
ters text on the current line with 
new words. 


:s/text/new_words/g<CR> _ |Replaces every occurrence of text on the 
current line with new_words. 


:<g/text/s//new_words/g<CR> |Replaces every occurrence of text in the 
file with new_words. 


Figure 6-14: Summary of Line Editor Commands 
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There are five basic command sequences to quit the vi editor. Commands 
that are preceded by a colon (:) are line editor commands. 


<ZZ> or :wq<CR> 
“tw filename <CR> 
79q<CR> 


:w! filename<CR> 
79q<CR> 


7q!<CR> 


79q<CR> 


Write the contents of the vi buffer to the UNIX file 
currently being edited and quit vi. 


Write the temporary buffer to a new file named 
filename and quit vi. 


Overwrite an existing file called filename with the 
contents of the buffer and quit vi. 


Quit vi without writing the buffer to a file, and dis- 
card all changes made to the buffer. 


Quit vi without writing the buffer to a UNIX file. 
This works only if you have made no changes to the 
buffer; otherwise vi will warn you that you must either 
save the buffer or use the :q!<CR> command to ter- 
minate. 


The <ZZ> command and :wq command sequence both write the contents of 
the buffer to a file, quit vi, and return you to the shell. You have tried the 
<ZZ> command. Now try to exit vi with :wq. vi remembers the name of the 
file currently being edited, so you do not have to specify it when you want to write 
the buffer’s contents back into the file. Type 


:wq<CR> 


The system responds in the same way it does for the <ZZ> command. It tells 
you the name of the file, and reports the number of lines and characters in the 


file. 


What must you do to give the file a different name? For example, suppose 
you want to write to a new file called junk. Type: 


sw junk<CR> 


After you write to the new file, leave vi. Type: 
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79q<CR> 
If you try to write to an existing file, you will receive a warning. For exam- 
ple, if you try to write to a file called johnson, the system will respond with: 
"Johnson" File exists - use "w! johnson" to overwrite 


If you want to replace the contents of the existing file with the contents of the 
buffer, use the :w! command to overwrite johnson. 


:w! johnson<CR> 
Your new file will overwrite the existing one. 


If you edit a file called memo, make some changes to it, and then decide you 
don’t want to keep the changes, or if you accidentally press a key that gives vi a 
command you cannot undo, leave vi without writing to the file. Type: 


:q!<CR> 


Figure 6-15 summarizes the quit commands. 
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<ZZ> Write the file and quit vi. 
:wq <CR> Write the file and quit vi. 


ww filename<CR> Write the editing buffer to a new file (filename) and 
79q<CR> quit vi. 


sw! filename<CR> Overwrite an existing file (filename) with the con- 
:9q<CR> tents of the editing buffer and quit vi. 


:q!<CR> Quit vi without writing buffer to a file. 


:9q<CR> Quit vi without writing the buffer to a file. 


Figure 6-15: Summary of the Quit Commands 
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The vi command has some special options. It allows you to: 
™ recover a file lost by an interrupt to the UNIX system 
™@ place several files in the editing buffer and edit each in sequence, and 


m™ view the file at your own pace by using the vi cursor positioning commands 


Recovering a File Lost by an Interrupt 


If there is an interrupt or disconnect, the system will exit the vi command 
without writing the text in the buffer back to its file. However, the UNIX system 
will store a copy of the buffer for you. When you log back in to the UNIX sys- 
tem you will be able to restore the file with the —r option for the vi command. 


Type 
vi —r filename<CR> 


The changes you made to filename before the interrupt occurred are now in the vi 
buffer. You can continue editing the file, or you can write the file and quit vi. 
The vi editor will remember the file name and write to that file. 


Editing Multiple Files 


If you want to edit more than one file in the same editing session, issue the vi 
command, specifying each file name. Type 
vi filel file2<CR> 


vi responds by telling you how many files you are going to edit. For example: 


2 files to edit 
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After you have edited the first file, write your changes (in the buffer) to the 
file (filel). Type 


>w<CR> 


The system response to the :w <CR> command will be a message at the bottom 
of the screen giving the name of the file, and the number of lines and characters 

in that file. Then you can bring the next file into the editing buffer by using the 

sn command. Type 


n<CR> 


The system responds by printing a notice at the bottom of the screen, telling you 
the name of the next file to be edited and the number of characters and lines in 
that file. 


Select two of the files in your current directory. Then enter vi and place the 
two files in the editing buffer at the same time. Notice the system responses to 
your commands at the bottom of the screen. 


Viewing a File 


It is often convenient to be able to inspect a file by using vi’s powerful search 
and scroll capabilities. However, you might want to protect yourself against 
accidentally changing a file during an editing session. The read-only option 
prevents you from writing in a file. To avoid accidental changes, you can set this 
option by invoking the editor as view rather than vi. 


Figure 6-16 summarizes the special options for Vi. 
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vi filel file2 file3<CR> | Enter three files (i/e/, file2, and file3) 
into the vi buffer to be edited. 


:w<CR> Write the current file and call the next 
n<CR> file into the buffer. 


vi —r filel<CR> Restore the changes made to filel. 


Figure 6-16: Summary of Special Options for vi 
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6-1. Try to restore a file lost by an interrupt. 
Enter vi, create some text in a file called exer6. Turn off your terminal 


without writing to a file or leaving vi. Turn your terminal back on, and 
log in again. Then try to get back into vi and edit exeré6. 


6-2. Place exerl and exer2 in the vi buffer to be edited. Write exerl and call 
in the next file in the buffer, exer2. 


Write exer2 to a file called junk. 


Quit vi. 


6-3. Try out the command: 
vi exer* <CR> 


What happens? Try to quit all the files as quickly as possible. 


6-4. Look at exer4 in read-only mode. 
Scroll forward. 
Scroll down. 
Scroll backward. 
Scroll up. 


Quit and return to the shell. 
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There is often more than one way to perform a task in vi. Any method that 
works is correct. The following are suggested ways of doing the exercises. 


Exercise 1 


1-1. Ask your system administrator for your terminal’s system name. Type: 


TERM =terminal_name<CR> 


1-2. Enter the vi command for a file called exerl: 
vi exer] <CR> 


Then use the append command (<a>) to enter the following text in your 
file: 


This is an exercise!<CR> 
Up, down<CR> 
left, right, <<CR> 


build your terminal’s<CR> 
muscles bit by bit<ESC> 


1-3. Use the <k> and <h> commands. 
1-4, Use the <x> command. 
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1-5. 
1-6. 


Use the <j> and <I> commands. 


Enter vi and use the append command (<a>) to enter the following text: 


) 


and byte by byte< ESC> 


Then use <j> and <I> to move to the last line and character of the 
file. Use the <a> command again to add text. You can create a new 
line by pressing the RETURN key. To leave text input mode, press the 
ESCAPE key. 


Type: 


<ZZ> 
Type: 


vi exer! <CR> 
Notice the system response: 


"exer1" 7 lines, 102 characters 


Exercise 2 


2-1. 
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Type: 
vi exer2 <CR> 
<a>1<CR> 
2<CR> 
3<CR> 


48<CR> 
49<CR> 
50<ESC> 
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2-2. Type: 
<“f> 
<"“b> 
<“u> 
<“d> 


Notice the line numbers as the screen changes. 


2-3. Type: 
<G> 
<o> 
123456789 123456789 < ESC> 
<7h> 
<3l> 


Typing <7h> puts the cursor 

on the 2 in the second set of numbers. 
Typing <3l> puts the cursor 

on the 5 in the 

second set of numbers. 


2-4. $ = end of line 
0 = first character in the line 


2-5. Type: 


2-6. Type: 


2-7. Type: 
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Exercise 3 


3-1. Type: 
vi exer3<CR> 
3-2. Type: 
<a> Append text <CR> 
Insert text<CR> 
a computer’s <CR> 
job is boring. <ESC> 
3-3. Type: 
<O> 
financial statement and <ESC> 
3-4. Type: 


<3G> 
<i> Delete text<CR> <ESC> 


The text in your file now reads: 


Append text 
Insert text 
Delete text 
a computer’s 
financial statement and 
job is boring. 
3-5. The current line is a computer’s. To create a line of text below that line 
use the <o> command. 


3-6. The current line is byte of the budget. 
<G> puts you on the bottom line. 
<A> lets you begin appending at the end of the line. 
<CR> creates the new line. 2 
Add the sentence: But, it is an exciting machine. 
<ESC> leaves append mode. 


3-7. Type: 
<1G> 


/text 
<i>some<space bar> <ESC> 
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3-8. <ZZ> will write the buffer to exer3 and return you to the shell. 


Exercise 4 


4-1. Type: 
vi exer4<CR> 
<a> When in the course of human events <CR> 
there are many repetitive, boring<CR> 
chores, then one ought to get a<CR> 
robot to perform those chores. < ESC> 


4-2. Type: 
<2G> 
<A> tedious and unsavory <8BACKSPACE> <CR> 
<ESC> 


Press <h> until you get to the b of boring. Then type: 
<dw>. (You can also use <6x>.) 


4-3. You are at the second line. Type: 
<2j> 
<I> congenial and computerized < ESC> 
<dd> 


To delete the line and leave it blank, type in: 
<0> (zero moves the cursor to the beginning of the line) 


<D> 


<H> 
<3dd> 


4-4, Write and quit vi. 
<ZZ> 
Remove the file. 


rm exer4<CR> 
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Exercise 5 


5-1. 


5-2. 


5-3. 


5-4. 


Exercise 6 


6-1. 
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Type: 


Type: 


Type: 


Type: 


Type: 


vi exer2<CR> 
<8G> 
<cc> END OF FILE <ESC> 


<1G> 
<8"zyy> 
<G> 
<"zp> 


<8G> 
<cc> 8 is great<ESC> 


<G> 

<2w> 

<cw> 

EXERCISE <ESC> 
<2b> 

<cw> 

TO<ESC> 


vi exer6<CR> 
<a> (append several lines of text) 
<ESC> 


Turn off the terminal. 


Turn on the terminal. 
Log in on your UNIX system. Type: 


vi —r exer6<CR> 
:wq <CR> 
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6-2. Type: 
vi exerl exer2<CR> 
>w<CR> 
n<CR> 


:w junk <CR> 
<ZZ> 


6-3. Type: 
vi exer* <CR> 


(Response:) 
8 files to edit (vi calls all files with names that begin with exer.) 


<ZZ> 
<ZZ> 


6-4. Type: 
view exer4<CR> 
<"“f> 
<“d> 
<“b> 
<“*u> 
79q<CR> 
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Introduction 


This chapter describes how to use the UNIX system shell to do routine tasks. 
For example, it shows you how to use the shell to manage your files, to manipu- 
late file contents, and to group commands together to make programs the shell 
can execute for you. 


The chapter has two major sections. The first section, "Shell Command 
Language," covers in detail using the shell as a command interpreter. It tells you 
how to use shell commands and characters with special meanings to manage files, 
redirect standard input and output, and execute and terminate processes. The 
second section, "Shell Programming," covers in detail using the shell as a pro- 
gramming language. It tells you how to create, execute, and debug programs 
made up of commands, variables, and programming constructs like loops and case 
statements. Finally, it tells you how to modify your login environment. 


The chapter offers many examples. You should login to your UNIX system 
and recreate the examples as you read the text. As in the other examples in this 
guide, different type (bold, italic, and constant width) is used to distinguish 
your input from the UNIX system’s output. See "Notation Conventions" in the 
Preface for details. 


In addition to the examples, there are exercises at the end of both the "Shell 
Command Language" and "Shell Programming" sections. The exercises can help 
you better understand the topics discussed. The answers to the exercises are at 
the end of the chapter. 


Your UNIX system might not have all commands referenced in this chapter. If 
NOTE you cannot access a command, check with your system administrator. 


If you want an overview of how the shell functions as both command inter- 
preter and programming language, see Chapters 1 and 4 before reading this 
chapter. Also, refer to Appendix E, Summary of Shell Command Language. If 
you want to learn more advanced concepts in shell programming, you might read 
Shell Commands and Programming (see the Documentation Roadmap for infor- 
mation on ordering this manual). 
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This section introduces commands and, more importantly, some characters 
with special meanings that let you 
find and manipulate a group of files by using pattern matching 
run a command in the background or at a specified time 
run a group of commands sequentially 


redirect standard input and output from and to files and other commands 


terminate processes 


It first covers the characters having special meanings to the shell and then covers 
the commands and notation for carrying out the tasks listed above. For your con- 
venience, Figure 7-1 summarizes the characters with special meanings discussed 
in this chapter. 
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metacharacters that provide a shortcut for specifying file 
names by pattern matching 


places commands in background mode, leaving your termi- 
nal free for other tasks 


separates multiple commands on one command line 


turns off the meaning of special characters such as *, ?, 
[], &,3, >, <, and|. 


single quotes turn off the delimiting meaning of a space 
and the special meaning of all special characters 


double quotes turn off the delimiting meaning of a space 
and the special meaning of all special characters except $ 
and * 


redirects output of a command into a file (replaces exist- 
ing contents) 


redirects input for a command to come from a file 


redirects output of a command to be added to the end of 
an existing file 


creates a pipe of the output of one command to the input 
of another command 


grave accents allow the output of a command to be used 
directly as arguments on a command line 


used with positional parameters and user-defined variables; 
also used as the default shell prompt symbol 


Figure 7-1: Characters with Special Meanings in the Shell Language 
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Metacharacters 


Metacharacters, a subset of the special characters, represent other characters. 
They are sometimes called wild cards, because they are like the joker in card 
games that can be used for any card. The metacharacters * (asterisk), ? (ques- 
tion mark), and [ ] (brackets) are discussed here. 


These characters are used to match file names or parts of file names, thereby 
simplifying the task of specifying files or groups of files as command arguments. 
(The files whose names match the patterns formed from these metacharacters 
must already exist.) This is known as file name expansion. For example, you may 
want to refer to all file names containing the letter "a", all file names consisting of 
five letters, and so on. 


The Metacharacter That Matches All Characters: the Asterisk (*) 


The asterisk (*) matches any string of characters, including a null (empty) 
string. You can use the * to specify a full or partial file name. The * alone 
refers to all the file and directory names in the current directory. To see the 
effect of the *, try it as an argument to the echo(1) command. Type: 


echo *<CR> 


The echo command displays its arguments on your screen. Notice that the system 
response to echo * is a listing of all the file names in your current directory. 
However, the file names are displayed horizontally rather than in vertical columns 
such as those produced by the Ils command. 


Figure 7-2 summarizes the syntax and capabilities of the echo command. 
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Command Recap 


echo — write any arguments to the output 


command options arguments 


echo none any character(s) 


Description: echo writes arguments, which are separated by 
blanks and ended with <CR>, to the output. 


| Remarks: In shell programming, echo is used to issue 
instructions, to redirect words or data into a file, 
and to pipe data into a command. All these uses 
will be discussed later in this chapter. 


Figure 7-2: Summary of the echo Command 


The * isa powerful character. For example, if you type rm * you will erase all 
the files in your current directory. Be very careful how you use it! 


For another example, say you have written several reports and have named 
them report, report1, reportla, report!b.01, report25, and report316. By typing 
reportl* you can refer to all files that are part of report!, collectively. To find 
out how many reports you have written, you can use the Ils command to list all 
files that begin with the string "report," as shown in the following example. 
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$ Is report* <<CR> 
report 

report 1 

reporti1a 


report 1b.01 
report25 
report3 16 

$ 


The * matches any characters after the string "report," including no letters at all. 
Notice that * matches the files in numerical and alphabetical order. A quick and 
easy way to print the contents of your report files in order on your screen is by ~ 
typing the following command: 


pr report* <CR> 


_ Now try another exercise. Choose a character that all the file names in your 
current directory have in common, such as a lower case "a". Then request a list- 
ing of those files by referring to that character. For example, if you choose a 


lower case "a", type the following command line: 
Is *a*<CR> 


The system responds by printing the names of all the files in your current direc- 


tory that contain a lower case "a". 


The * can represent characters in any part of the file name. For example, if 
you know that several files have their first and last letters in common, you can 
request a list of them on that basis. For such a request, your command line might 
look like this: 


Is F*FE<CR> 


The system response will be a list of file names that begin with F, end with E, and 
are in the following order: 
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F123E 
FATE 
FE 
Fig3.4E 


The order is determined by the ASCII sort sequence: (1) numbers; (2) upper case 
letters; (3) lower case letters. 


The Metacharacter That Matches One Character. the Question Mark (?) 


The question mark (?) matches any single character of a file name. Let’s say 
you have written several chapters in a book that has twelve chapters, and you 
want a list of those you have finished through Chapter 9. Use the ls command 
with the ? to list all chapters that begin with the string "chapter" and end with 
any single character, as shown below: 


$ Is chapter? <<CR> 
chapter 1 
chapter2 


chapter5 
chapter9 
$ 


The system responds by printing a list of all file names that match. 


Although ? matches any one character, you can use it more than once in a 
file name. To list the rest of the chapters in your book, type: 


Is chapter??? <CR> 
Of course, if you want to list all the chapters in the current directory, use the *: 


Is chapter* 
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Using the * or ? to Correct Typing Errors 


Suppose you use the mv(1) command to move a file, and you make an error 
and enter a character in the file name that is not printed on your screen. The sys- 
tem incorporates this non-printing character into the name of your file and subse- 
quently requires it as part of the file name. If you do not include this character 
when you enter the file name on a command line, you get an error message. You 
can use * or ? to match the file name with the non-printing character and rename 
it to the correct name. 


Try the following example. 


I. 
2. 


Make a very short file called trial. 
Type: mv trial trial<“g>1<CR> 


(Remember, to type <“g> you must hold down the CONTROL key and 


press the g key.) 
Type: Is triall<CR> 


The system will respond with an error message: 


$ Is triall<<CR> 
trial1: no such file or directory 
$ 


Type: Is trial?1<CR> 


The system will respond with the file name trial1 (including the non- 
printing character), verifying that this file exists. Use the ? again to 
correct the file name. 


$ mv trial?1 triall<CR> 
$ Is triall<CR> 

trial1 

$ 
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The Metacharacters That Match One of a Set: Brackets ([ |) 


Use brackets ([ ]) when you want the shell to match any one of several possi- 
ble characters that may appear in one position in the file name. For example, if 
you include [erf] as part of a file name pattern, the shell will look for file names 
that have the letter "c", the letter "r", or the letter "f" in the specified position, as 
the following example shows. 


$ Is [crflat<CR> 


This command displays all file names that begin with the letter "c", "r", or "f" and 
end with the letters "at". Characters that can be grouped within brackets in this 
way are collectively called a "character class". 


Brackets can also be used to specify a range of characters, whether numbers 
or letters. For example, if you specify 


chapter[1-5] 


the shell will match any files named chapter1 through chapter5. This is an easy 
way to handle only a few chapters at a time. 


Try the pr command with an argument in brackets: 
$ pr chapter[2-4]<CR> 


This command will print the contents of chapter2, chapter3, and chapter4, in that 
order, on your terminal. 
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A character class may also specify a range of letters. If you specify [A-Z], 
the shell will look only for upper case letters; if [a-z], only lower case letters. 


The uses of the metacharacters are summarized in Figure 7-3. Try out the 
metacharacters on the files in your current directory. 


matches any string of characters, including an empty 
(null) string 


matches any single character 


matches one of the sequence of characters specified within 
the brackets 


matches one of the range of characters specified 


Figure 7-3: Summary of Metacharacters 


Special Characters 


The shell language has other special characters that perform a variety of use- 
ful functions. Some of these additional special characters are discussed in this 
section; others are described in the next section, "Input and Output Redirection." 


Running a Command in Background: the Ampersand (& ) 


Some shell commands take considerable time to execute. The ampersand 
(&) is used to execute commands in background mode, thus freeing your termi- 
nal for other tasks. The general format for running a command in background 
mode is 


command & <CR> 
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You should not run interactive shell commands, for example read (see "Using the 
NOTE read Command" in this chapter), in the background. 


In the example below, the shell is performing a long search in background 
mode. Specifically, the grep(1) command is searching for the string "delinquent" 
in the file accounts.) Notice the & is the last character of the command line: 


$ grep delinquent accounts & <CR> 
21940 
$ 


When you run a command in the background, the UNIX system outputs a pro- 
cess number; 21940 is the process number in the example. You can use this 
number to stop the execution of a background command. (Stopping the execution 
of processes is discussed in the "Executing and Terminating Processes" section.) 
The prompt on the last line means the terminal is free and waiting for your com- 
mands; grep has started running in background. 


Running a command in background affects only the availability of your ter- 
minal; it does not affect the output of the command. Whether or not a command 
is run in background, it prints its output on your terminal screen, unless you 
redirect it to a file. (See "Redirecting Output," later in this chapter, for details.) 


If you want a command to continue running in background after you log off, 
you can submit it with the nohup(1) command. (This is discussed in "Using the 
nohup Command," later in this chapter.) 


Executing Commands Sequentially: the Semicolon (;) 


You can type two or more commands on one line as long as each pair is 
separated by a semicolon (;) , as follows: 


commandl; command2; command3<CR> 


The UNIX system executes the commands in the order that they appear in the 
line and prints all output on the screen. This process is called sequential execu- 
tion. 
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Try this exercise to see how the ; works. First, type 
cd; pwd; Is<CR> 
The shell executes these commands sequentially: 
1. cd changes your location to your login directory 
2. pwd prints the full path name of your current directory 
3. Is lists the files in your current directory 


If you do not want the system’s responses to these commands to appear on your 
screen, refer to "Redirecting Output" for instructions. 


Turning Off Special Meanings: the Backslash (\) 


The shell interprets the backslash (\) as an escape character that allows you 
to turn off any special meaning of the character immediately after it. To see how 
this works, try the following exercise. Create a two-line file called trial that con- 
tains the following text: 


The all * game 
was held in Summit. 


Use the grep command to search for the asterisk in the file, as shown in the fol- 
lowing example: 


$ grep \* trial<CR> 
The all * game 
$ 


The grep command finds the * in the text and displays the line in which it 
appears. Without the \, the * would be a metacharacter to the shell and would 
match all file names in the current directory. 


Turning Off Special Meanings: Quotes 


Another way to escape the meaning of a special character is to use quotation 
marks. Single quotes (’...”) turn off the special meaning of any character. Double 
quotes ("...") turn off the special meaning of all characters except $ and * (grave 
accent), which retain their special meanings within double quotes. An advantage 
of using quotes is that numerous special characters can be enclosed in the quotes; 
this can be more concise than using the backslash. 
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For example, if your file named trial also contained the line 
He really wondered why? Why??? 


you could use the grep command to match the line with the three question marks 
as follows: 


$ grep ’???’ trial<CR> 
He really wondered why? Why??? 
$ 


If you had instead entered the command 
grep ??? trial<CR> 


the three question marks would have been used as shell metacharacters and 
matched all file names of length three. 


Using Quotes to Turn Off the Meaning of a Space 


A common use of quotes as escape characters is for turning off the special 
meaning of the blank space. The shell interprets a space on a command line as a 
delimiter between the arguments of a command. Both single and double quotes 
allow you to escape that meaning. 


For example, to locate two or more words that appear together in text, make 
the words a single argument (to the grep command) by enclosing them in quotes. 
To find the two words "The all" in your file trial, enter the following command 
line: 


$ grep ‘The all’ trial<CR> 
The all * game 
$ 


grep finds the string "The all" and prints the line that contains it. What 
would happen if you did not put quotes around that string? 


The ability to escape the special meaning of a space is especially helpful when 
you are using the banner(1) command. This command prints a message across a 
terminal screen in large, poster size letters. 


To execute banner, specify a message consisting of one or more arguments (in 
this case usually words), separated on the command line by spaces. The banner 
will use these spaces to delimit the arguments and print each argument on a 
separate line. 
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To print more than one argument on the same line, enclose the words, 
together, in double quotes. For example, to send a birthday greeting to another 
user, type: 


banner happy birthday to you<CR> 


The command prints your message as a four-line banner. Now print the same 
message as a three-line banner. Type: 


banner happy birthday "to you"<CR> 


Notice that the words "to" and "you" now appear on the same line. The space 
between them has lost its meaning as a delimiter. 


Figure 7-4 summarizes the syntax and capabilities of the banner command. 


Command Recap 


banner — make posters 


command options arguments 
banner none characters 


Description: banner displays up to ten characters in large 
letters 


Remarks: Later in this chapter you will learn how to 
redirect the banner command into a file to be used 
as a poster. 


Figure 7-4: Summary of the banner Command 
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Input and Output Redirection 


In the UNIX system, some commands expect to receive their input from the 
keyboard (standard input) and most commands display their output at the termi- 
nal (standard output). However, the UNIX system lets you reassign the standard 
input and output to other files and programs. This is known as redirection. With 
redirection, you can tell the shell to 


@ take its input from a file rather than the keyboard 
™ send its output to file rather than the terminal 
M@ use a program as the source of data for another program 


You use a set of operators, the less than sign (<), the greater than sign (>), 
two greater than signs (>>), and the pipe @ to redirect input and output. 


Redirecting Input: the < Sign 


To redirect input, specify a file name after a less than sign (<) on a com- 
mand line: 


command < file<CR> 


For example, assume that, you want use the mail(1) command (described in 
Chapter 8) to send a message to another user with the login colleague and that 
you already have the message in a file named report. You can avoid retyping the 
message by specifying the file name as the source of input: 


mail colleague < report<CR> 


Redirecting Output to a File: the > Sign 


To redirect output, specify a file name after the greater than sign (>) ona 
command line: 


command > file<CR> 
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If you redirect output to a file that already exists, the output of your command 
will overwrite the contents of the existing file. 


; | 
Before redirecting the output of a command to a particular file, make sure 
that a file by that name does not already exist, unless you do not mind losing it. 
Because the shell does not allow you to have two files of the same name in a 
directory, it will overwrite the contents of the existing file with the output of your 
command if you redirect the output to a file with the existing file’s name. The 
shell does not warn you about overwriting the original file. 


To make sure there is no file with the name you plan to use, run the Is com- 
mand, specifying your proposed file name as an argument. If a file with that 
name exists, Is will list it; if not, you will receive a message that the file was not 
found in the current directory. For example, checking for the existence of the 
files temp and junk would give you the following output. 


$ Is temp<CR> 
temp 
$ Ils junk<CR> 


junk: no such file or directory 
$ 


This means you can name your new output file junk, but you cannot name it temp 
unless you no longer want the contents of the existing temp file. 
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Appending Output to an Existing File: the >> Symbol 


To keep from destroying an existing file, you can also use the double redirec- 
tion symbol (>>), as follows: 


command >> file<CR> 


This appends the output of a command to the end of the file file. If file does not 
exist, it is created when you use the >> symbol this way. 


The following example shows how to append the output of the cat command 
to an existing file. First, the cat command is first executed on both files without 
output redirection to show their respective contents. Then the contents of trial2 
are added after the last line of triall by executing the cat command on trial2 and 
redirecting the output to trial1. 


$ cat triall<CR> 

This is the first line of trial1. 
Hello. 

This is the last line of trial1. 

$ 

$ cat trial2<CR> 

This is the beginning of trial2. 

Hello. 

This is the end of trial2. 

$ 

$ cat trial2 >> triall<CR> 

$ cat triall<CR> 

This is the first line of trial. 
Hello. 

This is the last line of trial1. 

This is the beginning of trial2. 

Hello. 

This is the end of trial2. 

$ ‘ 
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Useful Applications of Output Redirection 


Redirecting output is useful when you do not want it to appear on your screen 
immediately or when you want to save it. Output redirection is also especially 
useful when you run commands that perform clerical chores on text files. Two 
such commands are spell and sort. 


The spell Command 


The spell program compares every word in a file against its internal vocabu- 
lary list and prints a list of all potential misspellings on the screen. If spell does 
not have a listing for a word (such as a person’s name), it will report that as a 
misspelling, too. 


Running spell on a lengthy text file can take a long time and may produce a 
list of misspellings that is too long to fit on your screen. spell prints all its output 
at once; if it does not fit on the screen, the command scrolls it continuously off the 
top until it has all been displayed. A long list of misspellings will roll off your 
screen quickly and may be difficult to read. 


You can avoid this problem by redirecting the output of spell to a file. In the 
following example, spell searches a file named memo and places a list of 
misspelled words in a file named misspell: 


$ spell memo > misspell<CR> 


Figure 7-5 summarizes the syntax and capabilities of the spell command. 
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Command Recap 


spell — find spelling errors 


command options arguments 


spell available* file 


Description: spell collects words from a specified file 
or files and looks them up in a spelling 
list. Words that are not on the spelling 
list are displayed on your terminal. 


Options: spell has several options, including one 
for checking British spellings. 


Remarks: The list of misspelled words can be 
redirected into a file. 


. See the spell(1) manual page in the User’s Reference Manual for all available options and an 


explanation of their capabilities. 


Figure 7-5: Summary of the spell Command 


The sort Command 


The sort command arranges the lines of a specified file in alphabetical order 
(see Chapter 3 for details). Because users generally want to keep a file that has 
been alphabetized, output redirection greatly enhances the value of this command. 


Be careful to choose a new name for the file that will receive the output of 
the sort command (the alphabetized list). When sort is executed, the shell first 
empties the file that will accept the redirected output. Then it performs the sort 
and places the output in the blank file. If you type 
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sort list > list<CR> 


the shell will empty list and then sort nothing into list. 


Combining Background Mode and Output Redirection 


Running a command in background does not affect the command’s output; 
unless it is redirected, output is always printed on the terminal screen. If you are 
using your terminal to perform other tasks while a command runs in background, 
you will be interrupted when the command displays its output on your screen. 
However, if you redirect that output to a file, you can work undisturbed. 


For example, in the "Special Characters" section you learned how to execute 
the grep command in background with &. Now suppose you want to find 
occurrences of the word "test" in a file named schedule. Run the grep command 
in background and redirect its output to a file called testfile: 


$ grep test schedule > testfile & <CR> 
You can then use your terminal for other work and examine testfile when you 


have finished it. 


Redirecting Output to a Command: the Pipe (| ) 


The | character is called a pipe. Pipes are powerful tools that allow you to 
take the output of one command and use it as input for another command without 
creating temporary files. A multiple command line created in this way is called a 
pipeline. 


The general format for a pipeline is: 
command! | command2 | command3...<CR> 


The output of command] is used as the input of command2. The output of com- 
mand2 is then used as the input for command3. 


To understand the efficiency and power of a pipeline, consider the contrast 
between two methods that achieve the same results. 


™ To use the input/output redirection method, run one command and redirect 
its output to a temporary file. Then run a second command that takes the 
contents of the temporary file as its input. Finally, remove the temporary 
file after the second command has finished running. 
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= To use the pipeline method, run one command and pipe its output directly 
into a second command. 


For example, say you want to mail a happy birthday message in a banner to 
the owner of the login david. Doing this without a pipeline is a three-step pro- 
cedure. You must 


1. Enter the banner command and redirect its output to a temporary file: 


banner happy birthday > message.tmp 


2. Enter the mail command using message.tmp as its input: 


mail david < message.tmp 


3. Remove the temporary file: 


rm message.tmp 


However, by using a pipeline you can do this in one step: 


banner happy birthday | mail david<CR> 


A Pipeline Using the cut and date Commands 


The cut and date commands provide a good example of how pipelines can 
increase the versatility of individual commands. The cut command allows you to 
extract part of each line in a file. It looks for characters in a specified part of the 
line and prints them. To specify a position in a line, use the —c option and iden- 
tify the part of the file you want by the numbers of the spaces it occupies on the 
line, counting from the left-hand margin. 


For example, say you want to display only the dates from a file called birth- 
days. The file contains the following list: 
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The birthdays appear between the ninth and thirteenth spaces on each line. To 
display them, type: 


cut —c9-13 birthdays<CR> 


The output is shown below: 


Figure 7-6 summarizes the syntax and capabilities of the cut command. 
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Command Recap 


cut — cut out selected fields from each line of a file 
command options arguments 


—clist 
—flist [—d] 


Description: cut extracts columns from a table or fields from 
each line of a file 


Options: —c lists the number of character positions from 


the left. A range of numbers such as characters 
1—9 can be specified by —c1—9 


—f lists the field number from the left separated 
by a delimiter described by —d. 


—d gives the field delimiter for —f. The default 
is a space. If the delimiter is a colon, this would 
be specified by —d:. 


Remarks: If you find the cut command useful, you may also 
want to use the paste command and the split com- 
mand. 


Figure 7-6: Summary of the cut Command 


The cut command is usually executed on a file. However, piping makes it 
possible to run this command on the output of other commands, too. This is use- 
ful if you want only part of the information generated by another command. For 
example, you may want to have the time printed. The date command prints the 
day of the week, date, and time, as follows: 
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$ date<CR> 
Sat Dec 27 13:12:32 EST 1986 


Notice that the time is given between the twelfth and nineteenth spaces of the 
line. You can display the time (without the date) by piping the output of date 
into cut, specifying spaces 12—19 with the —c option. Your command line and its 
output will look like this: 


$ date | cut —c12-19<CR> 
13:14:56 


Figure 7-7 summarizes the syntax and capabilities of the date command. 
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Command Recap 


date - display the date and time 
command options arguments 


+%m%d% y* available* 
+%H% EMSS 


Description: date displays the current date and time on your 
terminal 


Options: +% followed by m (for month), d (for day), y (for 
year), H (for hour), M (for month), and S (for 


second) will echo these back to your terminal. You 
can add explanations such as: 


date “+ %H:%M is the time’ 


Remarks: If you are working on a small computer system of 
which you are both a user and the system 
administrator, you may be allowed to set the date 
and time using optional arguments to the date 
command. Check your reference manual for 
details. When working in a multiuser environ- 
ment, the arguments are available only to the sys- 
tem administrator. 


Figure 7-7: Summary of the date Command 


* See the date(1) manual page in the User’s Reference Manual for all available options and an 


explanation of their capabilities. 
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Substituting Output for an Argument 


The output of any command may be captured and used as arguments on a 
command line. This is done by enclosing the command in grave accents (....) and 
placing it on the command line in the position where the output should be treated 
as arguments. This is known as command substitution. 


For example, you can substitute the output of the date and cut pipeline com- 
mand used previously for the argument in a banner printout by typing the follow- 
ing command line: 


$ banner ‘date | cut —c12—19°<CR> 
Notice the results: the system prints a banner with the current time. 


The "Shell Programming" section in this chapter shows you how you can also 
use the output of a command line as the value of a variable. 


Executing and Terminating Processes 


This section discusses the following topics: 


™ how to schedule commands to run at a later time by using the batch or at 
command 


™ how to obtain the status of active processes 
™ how to terminate active processes 


™ how to keep background processes running after you have logged off 


Running Commands at a Later Time With the batch and at Commands 


The batch and at commands allow you to specify a command or sequence of 
commands to be run at a later time. With the batch command, the system deter- 
mines when the commands run; with the at command, you determine when the 
commands run. Both commands expect input from standard input (the terminal); 
the list of commands entered as input from the terminal must be ended by press- 
ing <“d> (control-d). 
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The batch command is useful if you are running a process or shell program 
that uses a large amount of system time. The batch command submits a batch 
job (containing the commands to be executed) to the system. The job is put in a 
queue, and runs when the system load falls to an acceptable level. This frees the 
system to respond rapidly to other input and is a courtesy to other users. 


The general format for batch is: 


batch<CR> 
first command<CR> 


last command <CR> 
<“d> 
If there is only one command to be run with batch, you can enter it as follows: 


batch command_line<CR> 
<“d> 


The next example uses batch to execute the grep command at a convenient 
time. Here grep searches all files in the current directory and redirects the output 
to the file dol.file. 


$ batch grep dollar * > dol-file<CR> 
<“d> 


job 155223141.b at Sun Dec 7 11:14:54 1986 


$ 


After you submit a job with batch, the system responds with a job number, date, 
and time. This job number is not the same as the process number that the system 
generates when you run a command in the background. 
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Figure 7-8 summarizes the syntax and capabilities of the batch Command. 


Command Recap 


batch — execute commands at a later time 


command options input 


batch none command lines 


Description: batch submits a batch job, which is placed in a 
queue and executed when the load on the system 
falls to an acceptable level. 


Remarks: The list of commands must end with a <“d> 
(control-d). 


Figure 7-8: Summary of the batch Command 


The at command allows you to specify an exact time to execute the com- 
mands. The general format for the at command is 


at time<CR> 
first command <CR> 


last command <CR> 
<“d> 


The time argument consists of the time of day and, if the date is not today, 
the date. 
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The following example shows how to use the at command to mail a happy 
birthday banner to login emily on her birthday: 


$ at 8:15am Feb 27<CR> 
banner happy birthday | mail emily <CR> 
<“d> 


job 453400603.a at Thurs Feb 27 08:15:00 1986 
$ 


Notice that the at command, like the batch command, responds with the job 
number, date, and time. 


If you decide you do not want to execute the commands currently waiting in a 
batch or at job queue, you can erase those jobs by using the —r option of the at 
command with the job number. The general format is 


at —r jobnumber<CR> 


Try erasing the previous at job for the happy birthday banner. Type in: 
at —r 453400603.a<CR> 


If you have forgotten the job number, the at —] command will give you a list of 
the current jobs in the batch or at queue, as the following screen shows: 
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$ at —I1<CR> 
user = mylogin 168302040.a at Sat Nov 29 13:00:00 1986 
user = mylogin 453400603.a at Fri Feb 27 08:15:00 1987 


$" 


Notice that the system displays the job number and the time the job will run. 


Using the at command, mail yourself the file memo at noon, to tell you it is 
lunch time. (You must redirect the file into mail unless you use the "here docu- 
ment," described in the "Shell Programming" section.) Then try the at command 
with the —I option: 


$ at 12:00pm<CR> 

mail mylogin < memo<CR> 

<“d> 

job 263131754.a at Jun 30 12:00:00 1986 


$ 

$ at -1<CR> 

user = mylogin 263131754.a at Jun 30 12:00:00 1986 
$ 


Figure 7-9 summarizes the syntax and capabilities of the at command. 
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Command Recap 


at — execute commands at a specified time 
command options arguments 


time (date) 
jobnumber 


Description: Executes commands at the time specified. You 
can use between one and four digits, and am or 
pm to show the time. To specify the date, give a 
month name followed by the number for the day. 
You do not need to enter a date if you want your 
job to run the same day. See the at(1) manual 
page in the User’s Reference Manual for other 
default times. 


Options: The —r option with the job number removes pre- 
viously scheduled jobs. 


The —I option (no arguments) reports the job 
number and status of all scheduled at and batch 
jobs. 


Remarks: Examples of how to specify times and dates with 
the at command: 


at 08:15am Feb 27 
at 5:14pm Sept 24 


Figure 7-9: Summary of the at Command 


374 USER’S GUIDE 


Shell Command Language 


Obtaining the Status of Running Processes 


The ps command gives you the status of all the processes you are currently 
running. For example, you can use the ps command to show the status of all 
processes that you run in the background using & (described in the earlier section 
"Special Characters"). 


The next section, "Terminating Active Processes," discusses how you can use 
the PID (process identification) number to stop a command from executing. A 
PID is a number from | to 30,000 that the UNIX system assigns to each active 
process. 


In the following example, grep is run in the background, and then the ps com- 
mand is issued. The system responds with the process identification (PID) and the 
terminal identification (TTY) number. It also gives the cumulative execution time 
for each process (TIME), and the name of the command that is being executed 
(COMMAND). 


$ grep word * > temp & <CR> 
28223 

$ 

$ ps<CR> 

PID TTY TIME COMMAND 


28124 tty100:00 sh 
28223 tty100:04 grep 
28224 tty100:04 ps 

$ 


Notice that the system reports a PID number for the grep command, as well 
as for the other processes that are running: the ps command itself, and the sh 
(shell) command that runs while you are logged in. The shell program sh inter- 
prets the shell commands and is discussed in Chapters 1 and 4. 
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Command Recap 


ps — report process status 
command options arguments 
ps several* none 


Description: ps displays information about active processes. 


Options: Several. If none are specified, ps displays the 
status of all active processes you are running. 


Remarks: Gives you the PID (process ID). This is needed 
to kill a process (stop the process from executing). 


See the ps(1) manual page in the User’s Reference Manual for all available options and an 
explanation of their capabilities. 


Figure 7-10: Summary of the ps Command 


Terminating Active Processes 


The kill command is used to terminate active shell processes. The general 
format for the kill command is 


kill PID<CR> 


You can use the kill command to terminate processes that are running in back- 


ground. Note that you cannot terminate background processes by pressing the 
BREAK or DELETE key. 
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The following example shows how you can terminate the grep command that 
you started executing in background in the previous example. 


$ kill 28223<CR> 
28223 Terminated 
$ 


Notice the system responds with a message and a $ prompt, showing that the 
process has been killed. If the system cannot find the PID number you specify, it 
responds with an error message: 


ki11:28223:No such process 


Figure 7-11 summarizes the syntax and capabilities of the kill command. 


Command Recap 


kill — terminate a process 


command options arguments 


kill available* job number or PID 


Description: kill terminates the process specified by the PID 
number. 


* See the kill(1) manual page in the User’s Reference Manual for all available options and an 


explanation of their capabilities. 


Figure 7-11: Summary of the kill Command 
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Using the nohup Command 


All processes are killed when you log off. If you want a background process 
to continue running after you log off, you must use the nohup command to submit 
that background command. 


To execute the nohup command, follow this format: 
nohup command & <CR> 


Notice that you place the nohup command before the command you intend to run 
as a background process. 


For example, say you want the grep command to search all the files in the 
current directory for the string "word" and redirect the output to a file called 
word.list, and you wish to log off immediately afterward. Type the command line 
as follows: 


nohup grep word * > word.list & <CR> 


You can terminate the nohup command by using the kill command. Figure 7-12 
summarizes the syntax and capabilities of the nohup command. 


Command Recap 


nohup — prevents interruption of command execution by hang ups 


command options arguments 
nohup none command line 


Description: Executes a command line, even if you hang up or 
quit the system. 


Figure 7-12: Summary of the nohup Command 


™ 
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Now that you have mastered these basic shell commands and notations, use 
them in your shell programs! The exercises that follow will help you practice 
using shell command language. The answers to the exercises are at the end of the 
chapter. 
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1-1. What happens if you use an * (asterisk) at the beginning of a file name? 
Try to list some of the files in a directory using the * with the last letter 
of one of your file names. What happens? 


1-2. Try the following two commands; enter them as follows: 


cat[0-9]* <CR> 
echo *<CR> 


1-3. Is it acceptable to use a ? at the beginning or in the middle of a file name 
generation? Try it. 


1-4, Do you have any files that begin with a number? Can you list them 
without listing the other files in your directory? Can you list only those 
files that begin with a lower case letter between a and m? (Hint: use a 
range of numbers or letters in [ ]). 


1-5. Is it acceptable to place a command in background mode on a line that is 
executing several other commands sequentially? Try it. What happens? 
(Hint: use ; and &.) Can the command in background mode be placed 
in any position on the command line? Try placing it in various positions. 
Experiment with each new character that you learn to see the full power 
of the character. 


1-6. Redirect the output of pwd and Is into a file by using the following com- 
mand line: 


cd; pwd; Is; ed trial<CR> 


Remember, if you want to redirect both commands to the same file, you 
have to use the >> (append) sign for the second redirection. If you do 
not, you will wipe out the information from the pwd command. 


1-7. Instead of cutting the time out of the date response, try redirecting only 
the date, without the time, into banner. What is the only part you need 
to change in the time command line? 


banner ‘date | cut —c12-19°.<CR> 
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You can use the shell to create programs—new commands. Such programs 
are also called "shell procedures." This section tells you how to create and execute 
shell programs using commands, variables, positional parameters, return codes, 
and basic programming control structures. 


The examples of shell programs in this section are shown two ways. First, the 
cat command is used in a screen to display the contents of a file containing a shell 
program: 


$ cat testfile<CR> 
first command 


last command 
$ 


Second, the results of executing the shell program appear after a command line: 


$ testfile<CR> 
program output 
$ 


You should be familiar with an editor before you try to create shell programs. 


Refer to the tutorials in Chapter 5 (for the ed editor) and Chapter 6 (for the vi 
editor). 
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Shell Programs 


Creating a Simple Shell Program 


We will begin by creating a simple shell program that will do the following 
tasks, in order. 


™ print the current directory 
m@ list the contents of that directory 


@ display this message on your terminal: "This is the end of the shell" pro- 
gram. 


Create a file called dl (short for directory list) using your editor of choice, 
and enter the following: 


pwd<CR> 
Is<CR> 
echo This is the end of the shell program.<CR> 


Now write and quit the file. You have just created a shell program! You can cat 
the file to display its contents, as the following screen shows: 


$ cat dl<CR> 


pwd 
ls 


echo This is the end of the shell program. 
$ 
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Executing a Shell Program 


One way to execute a shell program is to use the sh command. Type: 
sh dl<CR> 


The dl command is executed by sh, and the path name of the current directory is 
printed first, then the list of files in the current directory, and finally, the com- 
ment This is the end of the shell program. The sh command provides a 
good way to test your shell program to make sure it works. 


If dl is a useful command, you can use the chmod command to make it an 
executable file; then you can type dl by itself to execute the command it contains. 
The following example shows how to use the chmod command to make a file exe- 
cutable and then run the Is —1 command to verify the changes you have made in 
the permissions. 


$ chmod u+x dl<CR> 
$ Is —1<CR> 


1 login login 3661 Nov 2 10:28 mbox 
1 login login 48 Nov 15 10:50 dl 


Notice that chmod turns on permission to execute (+x) for the user (u). 
Now dl is an executable program. Try to execute it. Type: 


di<CR> 


You get the same results as before, when you entered sh dl to execute it. For fur- 
ther details about the chmod command, see Chapter 3. 
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Creating a bin Directory for Executable Files 


To make your shell programs accessible from all your directories, you can 
make a bin directory from your login directory and move the shell files to your 
bin. 

You must also set your shell variable PATH to include your bin directory: 

PATH = $PATH:$HOME/bin 


See "Variables" and "Using Shell Variables" in this chapter for more information 
about PATH. For more advanced information, refer to the manual Shell Com- 
mands and Programming. 


The following example will remind you which commands are necessary. In 
this example, dl is in the login directory. Type these command lines: 


cd<CR> 
mkdir bin<CR> 
my dl bin/dl<CR> 


Move to the bin directory and type the Ils —1 command. Does dl still have execute 
permission? | 


Now move to a directory other than the login directory, and type the follow- 
ing command: 


di<CR> 
What happened? 


Figure 7-13 summarizes your new shell program, dl. 
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Shell Program Recap 


dil — display the directory path and directory contents (user defined) 


command arguments 


dl none 


Description: dl displays the output of the shell command pwd 
and Is. 


Figure 7-13: Summary of the dl Shell Program 


It is possible to give the bin directory another name; if you do so, you need to 
change your shell variable PATH again. 


Warnings about Naming Shell Programs 


You can give your shell program any appropriate file name. However, you 
should not give your program the same name as a system command. If you do, 
the system will execute your command instead of the system command. For exam- 
ple, if you had named your dl program mv, each time you tried to move a file, the 
system would have executed your directory list program instead of mv. 


Another problem can occur if you name the dl file Is, and then try to execute 
the file. You would create an infinite loop, since your program executes the Is 
command. After some time, the system would give you the following error mes- 
sage: 


Too many processes, cannot fork 


What happened? You typed in your new command, Is. The shell read and exe- 
cuted the pwd command. Then it read the Is command in your program and tried 
to execute your Is command. This formed an infinite loop. 
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UNIX system designers wisely set a limit on how many times an infinite loop 
can execute. One way to keep this from happening is to give the path name for 
the system’s Is command, /bin/Is, when you write your own shell program. 


The following Is shell program would work: 


$ cat Is<CR> 


pwd. 
/bdin/1s 


echo This is the end of the shell program 


If you name your command Is, then you can only execute the system Is com- 
mand by using its full path name, /bin/s. 


Variables 


Variables are the basic data objects shell programs manipulate, other than 
files. Here we discuss three types of variables and how you can use them: 


™ positional parameters 
™@ special parameters 


™ named variables 
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Positional Parameters 


A positional parameter is a variable within a shell program whose value is set 
from an argument specified on the command line invoking the program. Posi- 
tional parameters are numbered and are referred to with a preceding $: $1, $2, 
$3, and so on. 


A shell program may reference up to nine positional parameters. If a shell 
program is invoked on with a command line that appears like this: 


Shell.prog pp1 pp2 pp3 pp4 pp5 pp6 pp7 pp8 pp9<CR> 


then positional parameter $1 within the program will be assigned the value ppl, 
positional parameter $2 within the program will be assigned the value pp2, and so 
on, when the shell program is invoked. 


Create a file called pp (short for positional parameters) to practice positional 
parameter substitution. Then enter the echo commands shown in the following 
screen. Enter the command lines so that running the cat command on your comp- 
leted file will produce the following output: 


$ cat pp<CR> 

echo The first positional parameter is: $1<CR> 
echo The second positional parameter is: $2<CR> 
echo The third positional parameter is: $3<CR> 
echo The fourth positional parameter is: $4<CR> 
$ 


If you execute this shell program with the arguments one, two, three, and four, 
you will obtain the following results (first you must make the shell program pp 
executable using the chmod command): 
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$ chmod u+x pp<CR> 

$ 

$ pp one two three four <CR> 

The first positional parameter is: one 


The second positional parameter is: two 
The third positional parameter is: three 
The fourth positional parameter is: four 
$ 


The following screen shows the shell program bbday, which mails a greeting 
to the login entered in the command line: 


$ cat bbday<CR> 
banner happy birthday | mail $1 


Try sending yourself a birthday greeting. If your login name is sue, your 
command line will be: | 


bbday sue<CR> 


Figure 7-14 summarizes the syntax and capabilities of the bbday shell program. 


' 
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Shell Program Recap 
bbday — mail a banner birthday greeting (user defined) 


command arguments 


bbday login 


Description: bbday mails the message happy birthday, in 
poster-sized letters, to the specified login. 


Figure 7-14: Summary of the bbday Command 


The who command lists all users currently logged in on the system. How can 
you make a simple shell program called whoson, that will tell you if the owner of 
a particular login is currently working on the system? 


Type the following command line into a file called whoson: 
who | grep $1<CR> 


The who command lists all current system users, and grep searches the output of 
the who command for a line containing the string contained as a value in the posi- 
tional parameter $1. 


Now try using your login as the argument for the new program whoson. For 
example, say your login is sue. When you issue the whoson command, the shell 
program substitutes sue for the parameter $1 in your program and executes as if 
it were: 


who | grep sue <CR> 


The output is shown on the follawing screen: 
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$ whoson sue<CR> 
sue tty26 Jan 24 13:35 
$ 


If the owner of the specified login is not currently working on the system, grep 
fails and the whoson prints no output. 


Figure 7-15 summarizes the syntax and capabilities of the whoson command. 


Shell Program Recap 


whoson — display login information if user is logged in (user defined) 


command arguments 


Description: If a user is on the system, whoson displays the user’s login, 
the TTY number, and the time and date the user logged 
in. 


Figure 7-15: Summary of the whoson Command 


The shell allows a command line to contains 128 arguments. However, a 
shell program is restricted to referencing nine positional parameters, $1 through 
$9, at a given time. This restriction can be worked around using the shift com- 
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mand, described in the manual Shell Commands and Programming. The special 
parameter $*, described in the next section, can also be used to access the values 
of all command line arguments. 


Special Parameters 


$# This parameter, when referenced within a shell program, contains the 
number of arguments with which the shell program was invoked. Its 
value can be used anywhere within the shell program. 


Enter the command line shown in the following screen in an executable shell 
program called get.num. Then run the cat command on the file: 


$ cat get.num<CR> 
echo The number of arguments is: $# 
$ 


The program simply displays the number of arguments with which it is 
invoked. For example: 


$ get.num test out this program<CR> 
The number of arguments is: 4 
$ 
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Figure 7-16 summarizes the get.num shell program. 


Shell Program Recap 


get.num — count and display the number of arguments (user defined) 


command | arguments | 


get.num (character_string) 


Description: get.num counts the number of arguments given to the 


command and then displays the total. 


Remarks: 


This command demonstrates the special parameter $#. 


Figure 7-16: Summary of the get.num Shell Program 


$* This special parameter, when referenced within a shell program, contains 
a string with all the arguments with which the shell program was 
invoked, starting with the first. You are not restricted to nine parameters 
as with the positional parameters $1 through $9.. 


You can write a simple shell program to demonstrate $*. Create a shell pro- 


gram called show.param that will echo all the parameters. Use the command line 
shown in the following completed file: 
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$ cat show.param<CR> 


echo The parameters for this command are: $« 
$ 


show.param will echo all the arguments you give to the command. Make 
show.param executable and try it out, using these parameters: 


Hello. How are you? 


$ show.param Hello. How are you? <<CR> 
The parameters for this command are: Hello. 
$ 


Notice that show.param echoes Hello. How are you? Now try show.param 
using more than nine arguments: 
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$ show.param one two 3 45 six 7 8 9 10 11<CR> 
The parameters for this command are: one two 3 45 six 7 8 9 10 11 
$ 


Once again, show.param echoes all the arguments you give. The $* parameter 
can be useful if you use file name expansion to specify arguments to the shell 
command. 


Use the file name expansion feature with your show.param command. For 
example, say you have several files in your directory named for chapters of a 
book: chap], chap2, and so on, through chap7. show.param will print a list of all 
those files. 


$ show.param chap? <CR> 
The parameters for this command are: chap? chap2 chap3 
Chap4 chap5 chap6 chap7 


$ 


Figure 7-17 summarizes the show.param shell program. 
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Shell Program Recap 


show.param — display all positional parameters (user defined) 


command arguments 


show.param (any positional parameters) 


Description: show.param displays all the parameters. 


Remarks: If the parameters are file name generations, the command 
will display each of those file names. 


Figure 7-17: Summary of the show.param Shell Program 


Named Variables 


Another form of variable that you can use within a shell program is a named 
variable. You assign values to named variables yourself. The format for assign- 
ing a value to a named variable is 


named_variable = value<CR> 
Notice that there are no spaces on either side of the = sign. 


In the following example, varl is a named variable, and myname is the value 
or character string assigned to that variable: 


var 1 =myname<CR> 
A $ is used in front of a variable name in a shell program to reference the 
value of that variable. Using the example above, the reference $var1 tells the 


shell to substitute the value myname (assigned to var1), for any occurrence of the - 
character string $var1. 
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The first character of a variable name must be a letter or an underscore. The 
rest of the name can be composed of letters, underscores, and digits. As in shell 
program file names, it is not advisable to use a shell command name as a variable 
name. Also, the shell has reserved some variable names you should not use for 
your variables. A brief explanation of these reserved shell variable names follows: 


™ CDPATH defines the search path for the ed command. 
= HOME is the default variable for the cd command (home directory). 


IFS defines the internal field separators (normally the space, the tab, and 
the carriage return). 


LOGNAME is your login name. 

MAIL names the file that contains your electronic mail. 

PATH determines the search path used by the shell to find commands. 
PS1 defines the primary prompt (default is $). 

PS2 defines the secondary prompt (default is >). 


TERM identifies your terminal type. It is important to set this variable if 
you are editing with Vi. 


= TERMINFO identifies the directory to be searched for information about 
your terminal, for example, its screen size. 


™ TZ defines the time zone (default is ESTSEDT). 


Many of these variables are explained in "Modifying Your Login Environment" 
later in this chapter. You can also read more about them on the sh(1) manual 
page in the User’s Reference Manual. 


You can see the value of these variables in your shell in two ways. First, you 
can type 


echo $variable_name 


The system outputs the value of variable name. Second, you can use the env(1) 
command to print out the value of all defined variables in the shell. To do this, 
type env on a line by itself; the system outputs a list of the variable names and 
values. 
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Assigning a Value to a Variable 


If you edit with vi, you know you can set the TERM variable by entering the 
following command line: 


TERM = terminal_name<CR> 
This is the simplest way to assign a value to a variable. 
There are several other ways to do this: 
m™ Use the read command to assign input to the variable. 


® Redirect the output of a command into a variable by using command sub- 
stitution with grave accents (... *). 


™ Assign a positional parameter to the variable. 


The following sections discuss each of these methods in detail. 


Using the read Command 


The read command used within a shell program allows you to prompt the user 
of the program for the values of variables. The general format for the read com- 
mand is: 


read variable<CR> 


The values assigned by read to variable will be substituted for $variable wherever 
it is used in the program. If a program executes the echo command just before 
the read command, the program can display directions such as Type in .... 
The read command will wait until you type a character string, followed by a 
RETURN key, and then make that string the value of the variable. 


The following example shows how to write a simple shell program called 
num.please to keep track of your telephone numbers. This program uses the fol- 
lowing commands for the purposes specified: 


echo to prompt you for a person’s last name 
read to assign the input value to the variable name 
grep to search the file list for this variable 
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Your finished program should look like the one displayed here: 


$ cat num.please<CR> 
echo Type in the last name: 
read name 


grep $name list 
$ 


Create a file called list that contains several last names and phone numbers. 


Then 


try running num.please. 


The next example is a program called mknum, which creates a list. mknum 
includes the following commands for the purposes shown. 


echo prompts for a person’s name 

read assigns the person’s name to the variable name 
echo asks for the person’s number 

read assigns the telephone number to the variable num 


echo adds the values of the variables name and num to the file list 


If you want the output of the echo command to be added to the end of list, you 
must use >> to redirect it. If you use >, list will contain only the last phone 
number you added. 


Running the cat command on mknum displays the program’s contents. When 
your program looks like this, you will be ready to make it executable (with the 
chmod command): 
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$ cat mknum<CR> 
echo Type in name 
read name 

echo Type in number 


read num 

echo $name $num >> list 

$ chmod u+x mknum<CR> 
$ 


Try out the new programs for your phone list. In the next example, mknum 
creates a new listing for Mr. Niceguy. Then num.please gives you Mr. Niceguy’s 
phone number: 


$ mknum<CR> 
Type in the name 
Mr. Niceguy <CR> 
Type in the number 
668-0007 <CR> 


$ num.please<CR> 
Type in last name 
Niceguy <CR> 

Mr. Niceguy 668-0007 
$ 


Notice that the variable name accepts both Mr. and Niceguy as the value. 


Figures 7-18 and 7-19 summarize the mknum and num.please shell programs, 
respectively. 


SHELL TUTORIAL 399 


Shell Programming 


Shell Program Recap 


mknum — place name and number on a phone list 


command | arguments 
mknum (interactive) 


Description: Asks you for the name and number of a person and adds 
that name and number to your phone list. 


Remarks: This is an interactive command. 


Figure 7-18: Summary of the mknum Shell Program 


Shell Program Recap 


num.please — display a person’s name and number 


command arguments 


num.please (interactive) 


Description: Asks you for a person’s last name, and then displays the 
person’s full name and telephone number. 


Remarks: This is an interactive command. 


Figure 7-19: Summary of the num.please Shell Program 
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Substituting Command Output for the Value of a Variable 


You can substitute a command’s output for the value of a variable by using 
command substitution. This has the following format: 


variable = ‘command <CR> 
The output from command becomes the value of variable. 


In one of the previous examples on piping, the date command was piped into 
the cut command to get the correct time. That command line was the following: 


date | cut —c12-19<CR> 


You can put this in a simple shell program called t that will give you the time. 


$ cat t<CR> 
time="date | cut —c12-19° 
echo The time is: $time 


$ 


Remember there are no spaces on either side of the equal sign. Make the file exe- 
cutable, and you will have a program that gives you the time: 
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$ chmod u+x t<CR> 
$ t<CR> 
The time is: 10:36 


$ 


Figure 7-20 summarizes your t program. 


Shell Program Recap 


t — display the correct time 


command arguments 


none 


Description: t gives you the correct time in hours and minutes. 


Figure 7-20: Summary of the t Shell Program 


Assigning Values with Positional Parameters 


You can assign a positional parameter to a named parameter by using the fol- 
lowing format: | 


varl =$1<CR> 
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The next example is a simple program called simp.p that assigns a positional 
parameter to a variable. The following screen shows the commands in simp.p: 


$ cat simp.p<CR> 
var 1=$1 
echo $var1 


$ 


Of course, you can also assign the output of a command that uses positional 
parameters to a variable, as follows: 


person=‘who | grep $1°<CR> 


In the next example, the program log.time keeps track of your whoson pro- 
gram results. The output of whoson is assigned to the variable person, and added 
to the file login.file with the echo command. The last echo displays the value of 
$person, which is the same as the output from the whoson command: 


$ cat log.time<CR> 
person=‘who i grep $1° 
echo $person >> login.file 


echo $person 
$ 
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The system response to log.time is shown in the following screen: 


$ log.time maryann<CR> 


maryann tty61 Apr 11 10:26 
$ 


Figure 7-21 summarizes the log.time shell program. 


Shell Program Recap 


log.time — log and display a specified login (user defined) 


log.time login 7 


Description: If the specified login is currently on the system, log.time 
places the line of information from the who command into 
the file login.file and then displays that line of information 
on your terminal. 


Figure 7-21: Summary of the log.time Shell Program 
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Shell Programming Constructs 


The shell programming language has several constructs that give added flexi- 
bility to your programs: 


= Comments let you document a program’s function. 


m™ The "here document" allows you to include within the shell program itself 
lines to be redirected to be the input to some command in the shell pro- 
gram. 


m™ The exit command lets you terminate a program at a point other than the 
end of the program and use return codes. 


™ The looping constructs, for and while, allow a program to iterate through 
groups of commands in a loop. 


™ The conditional control commands, if and case, execute a group of com- 
mands only if a particular set of conditions is met. 


™ The break command allows a program to exit unconditionally from a loop. 


Comments 


You can place comments in a shell program in two ways. All text on a line 
following a # (pound) sign is ignored by the shell. The # sign can be at the 
beginning of a line, in which case the comment uses the entire line, or it can occur 
after a command, in which case the command is executed but the remainder of 
the line is ignored. The end of a line always ends a comment. The general for- 
mat for a comment line is 


#comment <CR> 
For example, a program that contains the following lines will ignore them 
when it is executed: 


# This program sends a generic birthday greeting.<CR> 
# This program needs a login as<CR> 
# the positional parameter .<CR> 


Comments are useful for documenting a program’s function and should be 
included in any program you write. 
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The here Document 


A "here document" allows you to place into a shell program lines that are 
redirected to be the input of a command in that program. It is a way to provide 
input to a command in a shell program without needing to use a separate file. 

The notation consists of the redirection symbol << and a delimiter that specifies 
the beginning and end of the lines of input. The delimiter can be one character or 
a string of characters; the ! is often used. 


Figure 7-22 shows the general format for a here document. 


command < <delimiter<CR> 


input lines...<CR> 
delimiter<CR> 


Figure 7-22: Format of a Here Document 


In the next example, the program gbday uses a here document to send a gen- 
eric birthday greeting by redirecting lines of input into the mail command: 


$ cat ghday<CR> 
mail $1 «<<! 
Best wishes to you on your birthday. 


! 
$ 
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When you use this command, you must specify the recipient’s login as the argu- 
ment to the command. The input included with the use of the here document is: 
Best wishes to you on your birthday 
For example, to send this greeting to the owner of login mary, type: 
$ gbday mary <CR> 


Login mary will receive your greeting the next time she reads her mail messages: 


$ mail<CR> 
From mylogin Wed May 14 14:31 CDT 1986 
Best wishes to you on your birthday 


$ 


Figure 7-23 summarizes the format and capabilities of the gbday command. 


Shell Program Recap 
gbday - send a generic birthday greeting (user defined) 


command arguments 


gbday login | 


Description: gbday sends a generic birthday greeting to the 
owner of the login specified in the argument. 


Figure 7-23: Summary of the gbday Command 
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Using ed in a Shell Program 


The here document offers a convenient and useful way to use ed in a shell 
script. For example, suppose you want to make a shell program that will enter 
the ed editor, make a global substitution to a file, write the file, and then quit ed. 
The following screen shows the contents of a program called ch.text which does 
these tasks. 
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$ cat ch.text<CR> 
echo Type in the file name. 

read file 

echo Type in the exact text to be changed. 

read old text 

echo Type in the exact new text to replace the above. 
read new text 

ed — $file1 <<! 

g/$old_text/s//$new text/g 

Ww 


aq 
| 
$ 


Notice the — (minus) option to the ed command. This option prevents the 
character count from being displayed on the screen. Notice, also, the format of 
the ed command for global substitution: 


g/old_text/s//new_text/g<CR> 


The program uses three variables: filel, old_text, and new_text. When the pro- 
gram is run, it uses the read command to obtain the values of these variables. 
The variables provide the following information: 


file the name of the file to be edited 
old_text the exact text to be changed 
new_text the new text 
Once the variables are entered in the program, the here document redirects 
the global substitution, the write command, and the quit command into the ed 


command. Try the new ch.text command. The following screen shows sample 
responses to the program prompts: 
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$ ch.text<CR> 

Type in the filename. 

memo <CR> 

Type in the exact text to be changed. 
Dear John: <CR> 


Type in the exact new text to replace the above. 
To whom it may concern: <CR> 

$ cat memo<CR> 

To whom it may concern: 

$ 


Notice that by running the cat command on the changed file, you could 
examine the results of the global substitution. 


Figure 7-24 summarizes the format and capabilities of the ch.text command. 


Shell Program Recap 


ch.text — change text in a file 


command arguments 


ch.text (interactive) 


Description: Replaces text in a file with new text. 


Remarks: This shell program is interactive. It will prompt 
you to type in the arguments. 


Figure 7-24: Summary of the ch.text Command 
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If you want to become more familiar with ed, see Chapter 5, "Line Editor 
Tutorial (ed)." The stream editor sed can also be used in shell programming. 
You can find more information on the sed editor in the Editing Guide or Editing 
Utilities Guide. 


Return Codes 


Most shell commands issue return codes that indicate whether the command 
executed properly. By convention, if the value returned is 0 (zero) than the com- 
mand executed properly; any other value indicates that it did not. The return 
code is not printed automatically, but is available as the value of the shell special 
parameter $?. 


Checking Return Codes 


After executing a command interactively, you can see its return code by typ- 
ing 
echo $? 


Consider the following example: 


$ cat hi 

This is file hi. 
$ echo $? 

0 

$ cat hello 


cat: cannot open hello 
$ echo $? 

2 

$ 


In the first case, the file hi exists in your directory and has read permission for 
you. The cat command behaves as expected and outputs the contents of the file. 
It exits with a return code of 0, which you can see using the parameter $?. In the 
second case, the file either does not exist or does not have read permission for you. 
The cat command prints a diagnostic message and exits with a return code of 2. 
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Using Return Codes With the exit Command 


A shell program normally terminates when the last command in the file is 
executed. However, you can use the exit command to terminate a program at 
some other point. Perhaps more importantly, you can also use the exit command 
to issue return codes for a shell program. For more information about exit, see 
the exit(2) manual page in the Programmer’s Reference Manual or Shell Com- 
mands and Programming. 


Looping 


In the previous examples in this chapter, the commands in shell programs 
have been executed in sequence. The for and while looping constructs allow a 
program to execute a command or sequence of commands several times. 


The for Loop 


The for loop executes a sequence of commands once for each member of a 
list. It has the following format: | 


for variable<CR> 
in a _list_of values<CR> 
do<CR> 
command 1<CR> 
command 2<CR> 


last command <CR> 
done<CR> 


Figure 7-25: Format of the for Loop Construct 


For each iteration of the loop, the next member of the list is assigned to the 
variable given in the for clause. References to that variable may be made any- 
where in the commands within the do clause. 
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It is easier to read a shell program if the looping constructs are visually clear. 
Since the shell ignores spaces at the beginning of lines, each section of commands 
can be indented as it was in the above format. Also, if you indent each command 
section, you can easily check to make sure each do has a corresponding done at 
the end of the loop. 


The variable can be any name you choose. For example, if you call it var, 
then the values given in the list after the keyword in will be assigned in turn to 
var; references within the command list to $var will make the value available. If 
the in clause is omitted, the values for var will be the complete set of arguments 
given to the command and available in the special parameter $*. The command 
list between the keywords do and done will be executed once for each value. 


When the commands have been executed for the last value in the list, the pro- 
gram will execute the next line below done. If there is no line, the program will 
end. 


The easiest way to understand a shell programming construct is to try an 
example. Create a program that will move files to another directory Include the 
following commands for the purposes shown: 


echo to prompt the user for a path name to the new 
directory. 

read to assign the path name to the variable path 

for variable to call the variable file; it can be referenced as $file 


in the command sequence. 


in Jist of values to supply a list of values. If the in clause is omit- 
ted, the list of values is assumed to be ~$* (all the 
arguments entered on the command line). 


do command sequence to provide a command sequence. The construct for 
this program will be: 


do 
my $file $path/$file<CR> 
done 
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The following screen shows the text for the shell program mv.file: 


$ cat mv.file<CR> 
echo Please type in the directory path 
read path 
for file 
in memo1 memo2 memo3 


do 

mv $file Spath/$file 
done 
$ 


In this program the values for the variable file are already in the program. 


To change the files each time the program is invoked, assign the values using posi- 
tional parameters or the read command. When positional parameters are used, 
the in keyword is not needed, as the next screen shows: 
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$ cat my.file<CR> 

echo type in the directory path 
read path 

for file 


do 

mv $file $path/$file 
done 
$ 
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You can move several files at once with this command by specifying a list of 
file names as arguments to the command. (This can be done most easily using 
the file name expansion mechanism described earlier). 


Figure 7-26 summarizes the mv.file shell program. 


Shell Program Recap 


my.file — move files to another directory (user defined) 


command arguments 


filenames 
(interactive) 


Description: Moves files to a new directory. 


Remarks: This program requires file names to be given as 
arguments. The program prompts for the path to 
the new directory. 


Figure 7-26: Summary of mv.file Shell Program 


The while Loop 


Another loop construct, the while loop, uses two groups of commands. It will 
continue executing the sequence of commands in the second group, the do...done 
list, as long as the final command in the first group, the while list, returns a status 
of true (meaning the command can be executed). 


The general format of the while loop is shown in Figure 7-27. 


SHELL TUTORIAL 415 


Shell Programming 


while <CR> 
command 1<CR> 


last command<CR> 
do<CR> 
command 1<CR> 


last command <CR> 
done<CR> 


Figure 7-27: Format of the while Loop Construct 


For example, a program called enter.name uses a while loop to enter a list of 
names into a file. The program consists of the following command lines: 


$ cat enter.name<CR> 
while 

read x 
do 


echo $x>>xfile 
done 
$ 
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With some added refinements, the program becomes: 


$ cat enter.name<CR> 

echo Please type in each person’s name and then a <CR> 
echo Please end the list of names with a <“d> 

while read x 

do 


echo $x>>xfile 
done 
echo xfile contains the following names: 
cat xfile 
$ 


Notice that after the loop is completed, the program executes the commands 
below the done. 


You used special characters in the first two echo command lines, so you must 
use quotes to turn off the special meaning. The next screen shows the results of 
enter.name: 


$ enter.name<CR> 

Please type in each person’s name and then a <CR> 
Please end the list of names with a <“d> 

Mary Lou<CR> 

Janice <CR> 


<“d> 

xfile contains the following names: 
Mary Lou 

Janice 


$ 
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Notice that after the loop completes, the program prints all the names contained 
in xfile. 


The Shell’s Garbage Can: /dev/null 


The file system has a file called /dev/null where you can have the shell deposit 
any unwanted output. 


Try out /dev/null by destroying the results of the who command. First, type 
in the who command. The response tells you who is on the system. Now, try the 
who command, but redirect the output into /dev/null: 


who > /dev/null<CR> 
Notice that the system responded with a prompt. The output from the who 
command was placed in /dev/null and was effectively discarded. 
Conditional Constructs 
if...then 


The if command tells the shell program to execute the then sequence of com- 
mands only if the final command in the if command list is successful. The if con- 
struct ends with the keyword fi. 


The general format for the if construct is shown in Figure 7-28. 
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if<CR> 
command I <CR> 


last command <CR> 
then<CR> 
command! <CR> 


last nena <CR> 
fi<CR> 


Figure 7-28: Format of the if...then Conditional Construct 


For example, a shell program called search demonstrates the use of the 
if...then construct. search uses the grep command to search for a word in a file. 
If grep is successful, the program will echo that the word is found in the file. 
Copy the search program (shown on the following screen) and try it yourself: 


$ cat search<CR> 

echo Type in the word and the file name. 
read word file 

if grep $word $file 


then echo $word is in $file 
fi 
$ 
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Notice that the read command assigns values to two variables. The first char- 
acters you type, up until a space, are assigned to word. The rest of the charac- 
ters, including embedded spaces, are assigned to file. 


A problem with this program is the unwanted display of output from the grep 
command. If you want to dispose of the system response to the grep command in 
your program, use the file /dev/null, changing the if command line to the follow- 
ing: 


if grep $word $file > /dev/null<CR> 


Now execute your search program. It should respond only with the message 
specified after the echo command. 


if...then...else 


The if...then construction can also issue an alternate set of commands with 
else, when the if command sequence is false. It has the following general format: 
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if<CR> 
command! <CR> 


last command <CR> 
then<CR> 
command!I <CR> 


last command <CR> 
else<CR> 
command! <CR> 


last command <CR> 
fi<CR> 


Figure 7-29: Format of the if...then...else Conditional Construct 


You can now improve your search command so it will tell you when it cannot 
find a word, as well as when it can. The following screen shows how your 
improved program will look: 
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$ cat search<CR> 
echo Type in the word and the file name. 
read word file 
if 
grep $word $file >/dev/null 
then 


echo $word is in $file 
else 

echo $word is NOT in $file 
fi 
$ 


Figure 7-30 summarizes your enhanced search program. 


Shell Program Recap 


search - tells you if a word is in a file (user defined) 


command arguments 


search interactive 


Description: Reports whether a word is in a file. 


Remarks: The command prompts you for the arguments 
(the word and the file) 


Figure 7-30: Summary of the search Shell Program 
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The test Command for Loops 


The test command, which checks to see if certain conditions are true, is a use- 
ful command for conditional constructs. If the condition is true, the loop will con- 
tinue. If the condition is false, the loop will end and the next command will be 
executed. Some of the useful options for the test command are: 


test —r file<CR> true if the file exists and is readable 

test —w file<CR> true if the file exists and has write permission 

test —x file<CR> true if the file exists and is executable 

test —s file<CR> true if the file exists and has at least one character 


test var! —eq var2<CR> true if varl equals var2 


test var! —ne var2<CR> true if var! does not equal var2 


You may want to create a shell program to move all the executable files in 
the current directory to your bin directory. You can use the test —x command to 
select the executable files. Review the example of the for construct that occurs in 
the mv.file program, shown in the following screen: 


$ cat mv.file<CR> 

echo type in the directory path 
read path 

for file 


do 

mv $file $path/$file 
done 
$ 


Create a program called mv.ex that includes an if test —x statement in the 
do...done loop to move executable files only. Your program will be as follows: 
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$ cat mv.ex<CR> 
echo type in the directory path 
read path 
for file 
do 
if test -x $file 


then 
mv $file $path/$file 
fi 
done 
$ 


The directory path will be the path from the current directory to the bin 
directory. However, if you use the value for the shell variable HOME, you will 
not need to type in the path each time. S$HOME gives the path to the login direc- 
tory. SHOME/bin gives the path to your bin. 


In the following example, my.ex does not prompt you to type in the directory 
name, and therefore, does not read the path variable: 


$ cat mv.ex<CR> 
for file 
do 
if test -x $file 
then 


mv $file $HOME/bin/$file 


fi 
done 
$ 
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Test the command, using all the files in the current directory, specified with 
the “*” metacharacter as the command argument. The command lines shown in 
the following example execute the command from the current directory and then 
changes to bin and lists the files in that directory. All executable files should be 
there. 


$ my.ex *<CR> 

$ cd; cd bin; ls<CR> 
list_of executable_files 
$ 


Figure 7-31 summarizes the format and capabilities of the mv.ex shell pro- 
gram. 
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Shell Program Recap 


my.ex — move all executable files in the current 
directory to the bin directory 


mv.ex * (all file names) 


Description: Moves all files in the current directory with exe- 
cute permission to the bin directory. 


Remarks: All executable files in the bin directory (or any 
directory shown by the PATH variable) can be 
executed from any directory. 


Figure 7-31: Summary of the mv.ex Shell Program 


case..esac 


The case...esac construction has a multiple choice format that allows you to 
choose one of several patterns and then execute a list of commands for that pat- 
tern. The pattern statements must begin with the keyword in, and a ) must be 
placed after the last character of each pattern. The command sequence for each 
pattern is ended with ;;. The case construction must be ended with esac (the 
letters of the word case reversed). 


The general format for the case construction shown in Figure 7-32: 
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case word<CR> 
in<CR> 
patternl) <CR> 
command line 1<CR> 


last command line<CR> 
3<CR> 
pattern2) <CR> 

command line 1<CR> 


last command line<CR> 
3<CR> 
pattern3) <CR> 

command line 1<CR> 


last command line<CR> 
3<CR> 
*) <<CR> 

command I1<CR> 


last command <CR> 
3<CR> 
esac <CR> 


Figure 7-32: The case...esac Conditional Construct 


The case construction tries to match the word following the word case with the 
pattern in the first pattern section. If there is a match, the program executes the 
command lines after the first pattern and up to the corresponding 53. 
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If the first pattern is not matched, the program proceeds to the second pat- 
tern. Once a pattern is matched, the program does not try to match any more of 
the patterns, but goes to the command following esac. 


The * used as a pattern matches any word, and so allows you to give a set 
of commands to be executed if no other pattern matches. To do this, it must be 
placed as the last possible pattern in the case construct, so that the other patterns 
are checked first. This provides a useful way to detect erroneous or unexpected 
input. 


The patterns that can be specified in the pattern part of each section may use 
the metacharacters *, ?, and [] as described earlier in this chapter for the shell’s 
file name expansion capability. This provides useful flexibility. 


The set.term program contains a good example of the case...esac construction. 
This program sets the shell variable TERM according to the type of terminal you 
are using. It uses the following command line: 


TERM =terminal_name<CR> 


(For an explanation of the commands used, see the vi tutorial in Chapter 6.) In 
the following example, the terminal is a Teletype 4420, Teletype 5410, or Tele- 
type 5420. 


set.term first checks to see whether the value of term is 4420. If it is, the pro- 
gram makes T4 the value of TERM, and terminates. If it the value of term is not 
4420, the program checks for other values: 5410 and 5420. It executes the com- 
mands under the first pattern that it finds, and then goes to the first command 
after the esac command. 


The pattern * , meaning everything else, is included at the end of the termi- 
nal patterns. It will warn that you do not have a pattern for the terminal 
specified and will allow you to exit the case construct: 
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$ cat set.term<CR> 
echo If you have a TTY 4420 type in 4420 
echo If you have a TTY 5410 type in 5410 
echo If you have a TTY 5420 type in 5420 
read term 
case $term 

in 


echo not a correct terminal type 


99 


esac 
export. TERM 

echo end of program 
$ 


Shell Programming 


Notice the use of the export command. You use export to make a variable 


available within your environment and to other shell procedures. What would 
happen if you placed the * pattern first? The set.term program would never 


assign a value to TERM, since it would always match the first pattern *, which 
means everything. 


Figure 7-33 summarizes the format and capabilities of the set.term shell pro- 


gram. 
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Shell Program Recap 


set.term - assign a value to TERM (user defined) 


command arguments 
set.term interactive 


Description: Assigns a value to the shell variable TERM and 
then exports that value to other shell procedures. 


Remarks: This command asks for a specific terminal code to 
be used as a pattern for the case construction. 


Figure 7-33: Summary of the set.term Shell Program 


Unconditional Control Statements: the break and continue Commands 


The break command unconditionally stops the execution of any loop in which 
it is encountered, and goes to the next command after the done, fi, or esac state- 
ment. If there are no commands after that statement, the program ends. 


In the example for set.term, you could have used the break command instead 
of echo to leave the program, as the next example shows: 
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$ cat set.term<CR> 

echo If you have a TIY 4420 type in 4420 
echo If you have a TTY 5410 type in 5410 
echo If you have a TTY 5420 type in 5420 
read term 

case $term 


esac 
export TERM 

echo end of program 
$ 


The continue command causes the program to go immediately to the next 
iteration of a do or for loop without executing the remaining commands in the 
loop. 


Debugging Programs 


At times you may need to debug a program to find and correct errors. There 
are two options to the sh command (listed below) that can help you debug a pro- 
gram: 


sh —v shellprogramname prints the shell input lines as they are read by 
the system 
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sh —x shellprogramname prints commands and their arguments as they 
are executed 


To try out these two options, create a shell program that has an error in it. 
For example, create a file called bug that contains the following list of commands: 


$ cat bug<CR> 
today= "date" 

echo enter person 
read person 

mail $1 


$person 

When you log off come into my office please. 
$today. 

MLH 

$ 


Notice that today equals the output of the date command, which must be 
enclosed in grave accents for command substitution to occur. 


The mail message sent to Tom ($1) at login tommy ($2) should read as the 
following screen shows: 
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$ mail<CR> 

Fron mlh Thm Apr 10 11:36 CST 1984 

Tom 

When you log off come into my office please. 


Thu Apr 10 11:36:32 CST 1986 
MLH 
? 


If you try to execute bug, you will have to press the BREAK or DELETE key 
to end the program. 


To debug this program, try executing bug using sh —v. This will print the 
lines of the file as they are read by the system, as shown below: 


$ sh —v bug tom<CR> 
today= "date 

echo enter person 
enter person 


read person 
tommy 
mail $1 


Notice that the output stops on the mail command, since there is a problem 
with mail. You must use the here document to redirect input into mail. 


Before you fix the bug program, try executing it with sh —x, which prints the 
commands and their arguments as they are read by the system: 
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$ sh —x bug tom tommy <CR> 

+date 

today=Thu Apr 10 11:07:23 CST 1986 
+ echo enter person 

enter person 


+ read person 
tommy 
+ mail tom 


$ 


Once again, the program stops at the mail command. Notice that the substi- 
tutions for the variables have been made and are displayed. 


The corrected bug program is as follows: 


$ cat bug<CR> 
today= "date" 

echo enter person 
read person 

mail $1 <<! 
$person 


When you log off come into my office please. 
$today 


The tee command is a helpful command for debugging pipelines. While sim- 
ply passing its standard input to its standard output, it also saves a copy of its 
input into the file whose name is given as an argument. 
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The general format of the tee command is: 
command]! | tee saverfile | command2<CR 
saverfile is the file that saves the output of command! for you to study. 


For example, say you want to check on the output of the grep command in 
the following command line: 


who | grep $1 | cut —cl-9<CR> 


You can use tee to copy the output of grep into a file called check, without dis- 
turbing the rest of the pipeline. 


who | grep $1 | tee check | cut —c1-9<CR> 


The file check contains a copy of the grep output, as shown in the following 
screen: 


$ who | grep mlhmo | tee check | cut —c1-9<CR> 
mihmo 
$ cat check<CR> 


tty61 Apr 10 11:30 


$ 


For further information about shell programming, including features such as 
command return codes, refer to the manual Shell Commands and Programming. 
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The UNIX system lets you modify your login environment in several ways. 
One modification that users commonly want to make is to change the default 
values of the erase (#) and line kill (@) characters. 


When you log in, the shell first examines a file in your login directory named 
.profile (pronounced "dot profile"). This file contains commands that control your 
shell environment. 


Because the .profile is a file, it can be edited and changed to suit your needs. 
On some systems you can edit this file yourself, while on others, the system 
administrator does this for you. To see whether you have a .profile in your home 
directory, type: 


Is —al SHOME 
If you can edit the file yourself, you may want to be cautious the first few 


times. Before making any changes to your .profile, make a copy of it in another 
file called safe.profile. Type: 


cp .profile safe.profile<CR> 
You can add commands to your .profile just as you add commands to any 


other shell program. You can also set some terminal options with the stty com- 
mand, and set some shell variables. 


Adding Commands fo Your .profile 
Practice adding commands to your .profile. Edit the file and add the follow- 
ing echo command to the last line of the file: 
echo Good Morning! I am ready to work for you. 
Write and quit the editor. 


Whenever you make changes to your .profile and you want to initiate them in 
the current work session, you may cause the commands in .profile to be executed 
directly using the . (dot) shell command. The shell will reinitialize your environ- 
ment by reading executing the commands in your .profile. Try this now. Type: 


. .profile<CR> 
The system should respond with the following: 
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Good Morning! I am ready to work for you. 
$ 


Setting Terminal Options 


The stty command can make your shell environment more convenient. There 
are three options you can use with stty: —tabs, erase <“h>, and echoe. 


stty —tabs This option preserves tabs when you are printing. It 
expands the tab setting to eight spaces, which is the 
default. The number of spaces for each tab can be 
changed. (See stty(1) in the User’s Reference 
Manual for details.) 


stty erase <“h> This option allows you to use the erase key on your 
keyboard to erase a letter, instead of the default 
character #. Usually the BACKSPACE key is the 
erase key. 


stty echoe If you have a terminal with a screen, this option 
erases characters from the screen as you erase them 
with the BACKSPACE key. 


If you want to use these options for the stty command, you can create those 
command lines in your .profile just as you would create them in a shell program. 
If you use the tail command, which displays the last few lines of a file, you can 
see the results of adding those four command lines to your .profile: 
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$ tail —4 .profile<CR> 
echo Good Morning! I am ready to work for you 
stty —tabs 


stty erase <“h> 
stty echoe 
$ 


Figure 7-34 summarizes the format and capabilities of the tail command. 


Command Recap 


tail — display the last portion of a file 
command options arguments 
tail —n filename 


Description: Displays the last lines of a file. 


Options: Use —n to specify the number of lines n (default 
is ten lines). You can specify a number of blocks 
(—nb) or characters (—nc) instead of lines. 


Figure 7-34: Summary of the tail Command 
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Creating an rje Directory 


We have often talked about sharing useful programs with other users in this 
chapter. Similarly, these users may have programs or other files that they want to 
share with you. So that these users can send you the files easily, you should 
create an rje (remote job entry) directory: 


mkdir rje 
chmod go +w rje 


Notice that you have to change the permissions of the directory using chmod. 
When you have an rje directory with the correct permissions, other users can send 
you files using the uucp command. See the uucp(1) manual page in the User’s 
Reference Manual for details. 


Using Shell Variables 


Several of the variables reserved by the shell are used in your .profile. You 
can display the current value for any shell variable by entering the following com- 
mand: 


echo $variable_name 
Four of the most basic of these variables are discussed next. 
HOME 


This variable gives the path name of your login directory. Use the cd 
command to go to your login directory and type: 


pwd <CR> 
What was the system response? Now type: 
echo SHOME<CR> 


Was the system response the same as the response to pwd? 
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SHOME is the default argument for the ed command. If you do not 
specify a directory, ed will move you to $SHOME. 


PATH 


This variable gives the search path for finding and executing com- 
mands. To see the current values for your PATH variable type: 


echo $PATH<CR> 


The system will respond with your current PATH value. 


$ echo $PATH<CR> 
:/mylogin/bin: /bin: /usr/bin: /usr/lib 


The colon (: ) is a delimiter between path names in the string 
assigned to the $PATH variable. When nothing is specified before a: , 
then the current directory is understood. Notice how, in the last example, 
the system looks for commands in the current directory first, then in 
/mylogin/bin/, then in /bin, then in /usr/bin, and finally in /usr/lib. 


If you are working on a project with several other people, you may 
want to set up a group bin, a directory of special shell programs used only 
by your project members. The path might be named /project1/bin. Edit 
your .profile, and add :/project1/bin to the end of your PATH, as in the 
next example. 


PATH =":/mylogin/bin: /bin: /usr /lib:/project1 /bin" <CR> 
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TERM 


This variable tells the shell what kind of terminal you are using. To 
put assign a value to it, you must execute the following three commands 
in this order: 


TERM = terminal_name<CR> 
export TERM <CR> 
tput init 


The first two lines, together, are necessary to tell the computer what type 
of terminal you are using. (For an explanation of exporting variables, see 
Shell Commands and Programming.) The last line, containing the tput 
command, tells the terminal that the computer is expecting to communi- 
cate with the type of terminal specified in the TERM variable. Therefore 
this command must always be entered after the variable has been 
exported. 


If you do not want to specify the TERM variable each time you log 
in, add these three command lines to your .profile; they will be executed 
automatically whenever you log in. To determine what terminal name to 
assign to the TERM variable, see the instructions in Appendix F, "Setting 
Up the Terminal." This appendix also contains details about the tput 
command. 


If you log in on more than one type of terminal, it would also be use- 
ful to have your set.term command in your .profile. 
PS1 


This variable sets the primary shell prompt string (the default is the 
$ sign). You can change your prompt by changing the PS1 variable in 
your .profile. 


Try the following example. Note that to use a multi-word prompt, 
you must enclose the phrase in quotes. Type the following variable 
assignment in your .profile. 


PS1="Your command is my wish<CR>" 


Now execute your .profile (with the . command) and watch for your new 
prompt sign. 


$ . .profile<CR> 
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Your command is my wish 


The mundane $ sign is gone forever, or at least until you delete the PS1 
variable from your .profile. 
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2-1. 


2-2. 


2-3. 


2-4. 
2-5. 


2-6. 


2-7. 
2-8. 


2-9. 


Create a shell program called time from the following command line: 


banner ‘date | cut —c12-19.<CR> 


Write a shell program that will give only the date in a banner display. 
Be careful not to give your program the same name as a UNIX system 
command. 


Write a shell program that will send a note to several people on your sys- 
tem. 


Redirect the date command without the time into a file. 


Echo the phrase Dear colleague in the same file that contains the date 
command, without erasing the date. 


Using the above exercises, write a shell program that will send a memo to 
the same people on your system mentioned in Exercise 2-3. Include in 
your memo: 


The current date and the words Dear colleague at the top of the 
memo : 
The body of the memo (stored in an existing file) 


The closing statement 


How can you read variables into the my.file program? 


Use a for loop to move a list of files in the current directory to another 
directory. How can you move all your files to another directory? 


How can you change the program search, so that it searches through 
several files? 


Hint: 


for file 
in $* 
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2-10. Set the stty options for your environment. 
2-11. Change your prompt to the word Hello. 


2-12. Check the settings of the variables SHOME, $STERM, and $PATH in 
your environment. 
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Command Language Exercises 


1-1. 


1-2. 


1-3. 
1-4. 


The * at the beginning of a file name refers to all files that end in that 
file name, including that file name. 


$ Ils *t<CR> 
cat 
123t 


new.t 
i 
$ 


The command cat [0-9]* will produce the following output: 


Imemo 
100data 
9 
O5name 


The command echo * will produce a list of all the files in the current 
directory. 

You can place ? in any position in a file name. 

The command Is [0-9]* will list only those files that start with a number. 


The command Is [a-m]* will list only those files that start with the letters 
"a" through "m". 
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1-5. If you placed the sequential command line in the background mode, the 
immediate system response was the PID number for the job. 


No, the & (ampersand) must be placed at the end of the command line. 


1-6. The command line would be: 


cd; pwd > junk; Ils >> junk; ed trial<CR> 


1-7. Change the —c option of the command line to read: 


banner ‘date | cut —cl-10°<CR> 


Shell Programming Exercises 


2-1. 


$ cat time<CR> 

banner ‘date i cut —c12-19° 
$ 

$ chmod u+x time<CR> 


$ time<CR> 
(banner display of the time 10:26) 
$ 
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$ cat mydate<CR> 
banner ‘date | cut —c1-10° 
$ 


$ cat tofriends<CR> 

echo Type in the name of the file containing the note. 
read note 

mail janice marylou bryan < $note 

$ 


Or, if you used parameters for the logins, instead of the logins themselves, 
your program may have looked like this: 
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2-4. 
2-5. 


448 


$ cat tofriends<CR> 
echo Type in the name of the file containing the note. 
read note 


mail $* < $note 


$ 


date | cut —cl-10 > filel<CR> 
echo Dear colleague >> filel<CR> 
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$ cat send.memo<CR> 

date | cut —c1-10 > memo1 

echo Dear colleague >> memo’ 

cat memo >> memo1 

echo A memo fram M. L. Kelly >> memo1 
mail janice marylou bryan < meno’ 

$ 


$ cat mvy.file<CR> 

echo type in the directory path 

read path 

echo type in file names, end with <“d> 
while 
read file 


do 
mv $file $path/$file 
done 
echo all done 
$ 


Answers To Exercises 
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Answers To Exercises 


2-8. 


$ cat mv.file<CR> 

echo Please type in directory path 
read path 

for file in $« 


do 
nv $file $path/$file 
done 
$ 


The command line for moving all files in the current directory is: 


5 my.file *<CR> 


2-9. See hint given with exercise 2-9. 


$ cat search<CR> 
for file 
in $x 
do 
if grep $word $file >/dev/null 


then echo $word is in $file 
else echo $word is NOT in $file 
fi 
done 
$ 
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2-10. Add the following lines to your .profile. 


stty —tabs<CR> 
stty erase <“h> <CR> 
stty echoe<CR> 


2-11. Add the following command lines to your .profile 
PS1=Hello<CR> 
export PS1 
2-12. To check the values of these variables in your home environment: 
« $ echo SHOME<CR> 
o $ echo $STERM<CR> 
o $ echo $PATH<CR> 
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Introduction 


The UNIX system offers a choice of commands that enable you to communi- 
cate with other UNIX system users. Specifically, they allow you to: send and 
receive messages from other users (on either your system or another UNIX sys- 
tem); exchange files; and form networks with other UNIX systems. Through net- 
working, a user on one system can exchange messages and files between comput- 
ers, and execute commands on remote computers. 


To help you take advantage of these capabilities, this chapter will teach you 
how to use the following commands. 


For exchanging messages: mail, mailx, uname, and uuname 
For exchanging files: uucp, uuto, uupick, and uustat 
For networking: ct, cu, and uux 
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To send messages you can use either the mail or mailx command. These 
commands deliver your message to a file belonging to the recipient. When the 
recipient logs in (or while already logged in), he or she receives a message that 
says you have mail. The recipient can use either the mail or mailx command to 
read your message and reply at his or her leisure. 


The main difference between mail and mailx is that only mailx offers the fol- 
lowing features: 


™ a choice of text editors (ed or vi) for handling incoming and outgoing mes- 
sages 

™ a list of waiting messages that allows the user to decide which messages to 
handle and in what order 


™ several options for saving files 


™ commands for replying to messages and sending copies (of both incoming 
and outgoing messages) to other users 


You can also use mail or mailx to send short files containing memos, reports, 
and so on. However, if you want to send someone a file that is over a page long, 
use one of the commands designed for transferring files: uuto or uucp. (See 
"Sending Large Files" later in this chapter for descriptions of these commands.) 
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This section presents the mail command. It discusses the basics of sending 
mail to one or more people simultaneously, whether they are working on the local 
system (the same system as you) or on a remote system. It also covers receiving 
and handling incoming mail. 


Sending Messages 


The basic command line format for sending mail is 
mail /Jogin<CR> 


where /ogin is the recipient’s login name on a UNIX system. This login name 
can be either of the following: 


™ a login name if the recipient is on your system (for example, bob) 


™ a system name and login name if the recipient is on another UNIX system 
that can communicate with yours (for example, sys2!bob) 


For the moment, assume that the recipient is on the local system. (We will deal 
with sending mail to users on remote systems later.) Type the mail command at 
the system prompt, press the RETURN key, and start typing the text of your 
message on the next line. There is no limit to the length of your message. When 
you have finished typing it, send the message by typing a period (.) or a <“d> 
(control-d) at the beginning of a new line. 


‘ The following example shows how this procedure will appear on your screen. 
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$ mail phyllis<CR> 

My meeting with Smith’s<CR> 

group tomorrow has been moved <CR> 
up to 3:00 so I won’t be able to<CR> 
see you then. Could we meet<CR> 

in the morning instead? <CR> 
.<CR> 

$ 


The prompt on the last line means that your message has been queued (placed in 
a waiting line of messages) and will be sent. 


Undeliverable Mail 


If you make an error when typing the recipient’s login, the mail command 
will not be able to deliver your mail. Instead, it will print two messages telling 
you that it has failed and that it is returning your mail. Then it will return your 
mail in a message that includes the system name and login name of both the 
sender and intended recipient, and an error message stating the reason for the 
failure. 


For example, say you (owner of the login kol) want to send a message to a 
user with the login chris on a system called marmaduk. Your message says The 
meeting has been changed to 2:00. Failing to notice that you have incorrectly 
typed the login as cris, you try to send your message. 
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$ mail cris<CR> 

The meeting has been changed to 2:00. 
.<CR> 

mail: Can’t send to cris 


mail: Return to kol 
you have mail in /usr/mail/kol 
$ 


The mail that is waiting for you in /usr/mail will be useful if you do not know 
why the mail command has failed, or if you want to retrieve your mail so that you 
can resend it without typing it in again. It contains the following: 


$ mail<CR> 

From kol Sat Jan 18 17:33 EST 1986 

>From kol Sat Jan 18 17:33 EST 1986 forwarded by kol 

***** UNDELIVERABLE MAIL sent to cris, being returned by marmaduk!kol «*««+« 
mail: ERROR # 8 ‘Invalid recipient’ encountered on system marmaduk 


The meeting has been changed to 2:00. 


? 


To learn how to display and handle this message see "Managing Incoming Mail" 
later in this chapter. 
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Sending Mail to One Person 


The following screen shows a typical message. 


$ mail tommy <CR> 

Tom, <CR> 

There’s a meeting of the review committee <CR> 
at 3:00 this afternoon. D.F. wants your <CR> 
comments and an idea of how long you think<CR> 


the project will take to complete.<CR> 
B.K.<CR> 

.<CR> 

$ 


When Tom logs in at his terminal (or while he is already logged in), he receives a 
message that tells him he has mail waiting: 


$ you have mail 


To find out how he can read his mail, see the section "Managing Incoming Mail" 
in this chapter. 


You can practice using the mail command by sending mail to yourself. Type 
in the mail command and your login ID, and then write a short message to your- 
self. When you type the final period or <“d>, the mail will be sent to a file 
named after your login ID in the /usr/mail directory, and you will receive a 
notice that you have mail. 


Sending mail to yourself can also serve as a handy reminder system. For 
example, suppose you (login ID bob) want to call someone the next morning. 
Send yourself a reminder in a mail message. 
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$ mail bob<CR> 
Call Accounting and find out<CR> 
why they haven’t returned my 1985 figures! <CR> 


.<CR> 
$ 


When you log in the next day, a notice will appear on your screen informing you 
that you have mail waiting to be read. 


Sending Mail to Several People Simultaneously 


You can send a message to a number of people by including their login names 
on the mail command line. For example: 


$ mail tommy jane wombat dave<CR> 

Diamond cutters, <CR> 

The game is on for tonight at diamond three. <CR> 
Don’t forget your gloves! <CR> | 


Your Manager <CR> 
.<CR> 
$ 


Figure 8-1 summarizes the syntax and capabilities of the mail command. 
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Command Recap 


mail — sends a message to another user’s login 


options arguments 


none | [system_name!]login 


Description: Typing mail followed by one or more login names, 
sends the message typed on the lines following the 
command line to the specified login(s). 


Remarks: Typing a period or a <“d> (followed by the 
RETURN key) at the beginning of a new line 
sends the message. 


Figure 8-1: Summary of Sending Messages with the mail Command 


Sending Mail to Remote Systems: the uname and uuname 
Commands 
Until now we have assumed that you are sending messages to users on the 
local UNIX system. However, your company may have three separate computer 


systems, each in a different part of a building, or you may have offices in several 
locations, each with its own system. 


You can send mail to users on other systems simply by adding the name of 
the recipient’s system before the login ID on the command line. 


mail sys2!bob<CR> 


Notice that the system name and the recipient’s login ID are separated by an 
exclamation point. 
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Before you can run this command, however, you need three pieces of informa- 
tion: 


™ the name of the remote system 
™ whether or not your system and the remote system communicate 
— the recipient’s login name 

The uname and uuname commands allow you to find this information. 


If you can, get the name of the remote system and the recipient’s login name 
from the recipient. If the recipient does not know the system name, have him or 
her issue the following command on the remote system: 


uname —n<CR> 
The command will respond with the name of the system. For example: 


$ uname —n<CR> 
Gumbo 
$ 


Once you know the remote system name, the uuname command can help you 
verify that your system can communicate with the remote system. At the prompt, 


type: 
uuname < CR> 


This generates a list of remote systems with which your system can communicate. 
If the recipient’s system is on that list, you can send messages to it by mail. 


You can simplify this step by using the grep command to search through the 
uuname output. At the prompt, type: 


uuname | grep systen<CR> 


(Here system is the recipient’s system name.) If grep finds the specified system 
name, it prints it on the screen. For example: 


$ uuname | grep dumbo<CR> 
dumbo 
$ 


This means that dumbo can communicate with your system. If dumbo does not 
communicate with your system, uuname returns a prompt. 
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$ uuname | grep dumbo<CR> 
$ 


To summarize our discussion of uname and uuname, consider an example. 
Suppose you want to send a message to login sarah on the remote system dumbo. 
Verify that dumbo can communicate with your system and send your message. 
The following screen shows both steps. 


$ uuname | grep dumbo<CR> 

Gumbo 

$ mail dumbo!sarah<CR> 

Sarah, <CR> 

The final counts for the writing seminar <<CR> 
are as follows: <CR> 

<CR> 


Our department — 18<CR> 
Your department — 20<CR> 
<CR> 

Tom<CR> 

.<CR> 

$ 


Figures 8-2 and 8-3 summarize the syntax and capabilities of the uname and 
uuname commands, respectively. 
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Command Recap 


uname — displays the system name 


options arguments 


—n and others* none 


Description: uname —n displays the name of the system on 
which your login resides. 


} 


Figure 8-2: Summary of the uname Command 


* See the uname(1) manual page in the User’s Reference Manual for all 


available options and an explanation of their capabilities. 


Command Recap 


uuname — displays a list of networked systems 
~ command options arguments 


uuname none none 


Description: uuname displays a list of remote systems that can 
communicate with your system. 


Figure 8-3: Summary of the uuname Command 
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Managing Incoming Mail 


As stated earlier, the mail command also allows you to display messages sent 
to you by other users on your screen so you can read them. If you are logged in 
when someone sends you mail, the following message is printed on your screen: 


you have mail 


This means that one or more messages are being held for you in a file called 
/usr/mail/your login, usually referred to as your mailbox. To display these mes- 
Sages on your screen, type the mail command without any arguments: 


mail<CR> 


The messages will be displayed one at a time, beginning with the one most 
recently received. A typical mail message display looks like this: 


$ mail 
From tommy Wed May 21 15:33 CST 1986 

Bob, 

Looks like the meeting has been cancelled. 

Do you still want the material for the technical review? 
Tom 


? 


The first line, called the header, provides information about the message: the 
login name of the sender and the date and time the message was sent. The lines 
after the header (up to the line containing the ?) comprise the text of the mes- 
sage. 


If a long message is being displayed on your terminal screen, you may not be 
able to read it all at once. You can interrupt the printing by typing <“s> 
(control-s). This will freeze the screen, giving you a chance to read. When you 
are ready to continue, type <“q> and the printing wili resume. 
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After displaying each message, the mail command prints a ? prompt and 
waits for a response. You have many options, for example, you can leave the 
current message in your mailbox while you read the next message; you can delete 
the current message; or you can save the current message for future reference. 
For a list of mail’s available options, type a ? in response to mail’s ? prompt. 


To display the next message without deleting the current message, press the 
RETURN key after the question mark. 
?<CR> 
The current message remains in your mailbox and the next message is displayed. 
If you have read all the messages in your mailbox, a prompt appears. 


To delete a message, type a d after the question mark: 
? d<CR> 


The message is deleted from your mailbox. If there is another message waiting, it 
is then displayed. If not, a prompt appears as a signal that you have finished 
reading your messages. 


To save a message for later reference, type an s after the question mark: 
? s<CR> 


This saves the message, by default, in a file called mbox in your home directory. 
To save the message in another file, type the name of that file after the s com- 
mand. 


For example, to save a message in a file called mailsave (in your current 
directory), enter the response shown after the question mark: 


? Ss mailsave<CR> 


If mailsave is an existing file, the mail command appends the message to it. If 
there is no file by that name, the mail command creates one and stores your mes- 
sage in it. You can later verify the existence of the new file by using the Is com- 
mand. (Is lists the contents of your current directory.) 
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You can also save the message in a file in a different directory by specifying a 
path name. For example: 


? Ss project! /memo<CR> 


This is a relative path name that identifies a file called memo (where your mes- 
sage will be saved) in a subdirectory (project1) of your current directory. You 
can use either relative or full path names when saving mail messages. (For 
instructions on using path names, see Chapter 3.) 


To quit reading messages, enter the response shown after the question mark: 
? q<CR> 
Any messages that you have not read are kept in your mailbox until the next time 


you use the mail command. 


To stop the printing of a message entirely, press the BREAK key. The mail 
command will stop the display, print a ? prompt, and wait for a response from 
you. 


Figure 8-4 summarizes the syntax and capabilities of the mail command for 
reading messages. 
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Command Recap 


mail — reads messages sent to your login 


command 


mail 


Description: 


Remarks: 


options arguments 


available* none 


When issued without options, the mail command 
displays any messages waiting in your mailbox 
(the system file /usr/mail/your login). 


A question mark (?) at the end of a message 
means that a response is expected. A full list of 
possible responses is given in the User’s Reference 
Manual. 


Figure 8-4: Summary of Reading Messages with the mail Command 


* See the mail(1) manual page in the User’s Reference Manual for all 
available options and an explanation of their capabilities. 
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This section introduces the mailx facility. It explains how to set up your 
mailx environment, send messages with the mailx command, and handle messages 
that have been sent to you. The material is presented in four parts: 


@ mailx Overview 
™ Sending Messages 
m@ Managing Incoming Mail 


= The .mailrc File 
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The mailx command is an enhanced version of the mail command. There are 
many options to mailx that are not available in mail for sending and reading mail. 
For example, you can define an alias for a single login or for a group. This allows 
you to send mail to an individual using a name or word other than their login ID, 
and to send mail to a whole group of people using a single name or word. When 
you use mailx to read incoming mail you can save it in various files, edit it, for- 
ward it to someone else, respond to the person who originated the message, and so 
forth. By using mailx environment variables you can develop an environment to 
suit your individual tastes. 


If you type the mailx command with one or more logins as arguments, mailx 
decides you are sending mail to the named users, prompts you for a summary of 
the subject, and then waits for you to type in your message or issue a command. 
The section "How to Send Messages" describes features that are available to you 
for editing, incorporating other files, adding names to copy lists, and more. 


If you enter the mailx command with no arguments, mailx checks incoming 
mail for you in a file named /usr/mail/your login. If there is mail for you in that 
file, you are shown a list of the items and given the opportunity to read, store, 
remove or transfer each one to another file. The section entitled "How to Manage 
Incoming Mail" provides some examples and describes the options available. 


If you choose to customize mailx, you should create a start-up file in your 
home directory called .mailrc. The section on "The .mailre File" describes vari- 
ables you can include in your start-up file. 


mailx has two modes of functioning: input mode and command mode. You 
must be in input mode to create and send messages. Command mode is used to 
read incoming mail. You can use any of the following methods to control the way 
mailx works for you: 


™ by entering options on the command line. (See the mailx(1) manual page 
in the User’s Reference Manual.) 


™@ by issuing commands when you are in input mode, for example, creating a 
message to send. These commands are always preceded by a ~ (tilde) and 
are referred to as tilde escapes. (See the mailx(1) manual page in the 
User’s Reference Manual.) 


@ by issuing commands when you are in command mode, for example, read- 
ing incoming mail. 
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™ by storing commands and environment variables in a start-up file in your 
home directory called SHOME/.mailrc. 


Tilde escapes are discussed in "Sending Messages," command mode com- 
mands in "Managing Incoming Mail," and the .mailre file in "The .mailre File." 
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In this section, we will look at command line options. 
The syntax for the mailx command is: 


mailx [options] [name...] 


The options are flags that control the action of the command, and name... 
represents the intended recipients. 


Anything on the command line other than an option preceded by a hyphen is 
read by mailx as a name; that is, the login or alias of a person to whom you are 
sending a message. 


Two of the command line options deserve special mention: 
m= —f [filename]: Allows you to read messages from filename instead of your 


mailbox. 


Because mailx lets you store messages in any file you name, you need the 
—f option to review these stored options. The default storage file is 
SHOME/mbox, so the command: 


mailx —f 
is used to review messages stored there. 
= —n: Do not initialize from the system default mailx.rc file. 
If you have your own .mailrc file (see "The .mailre File") mailx will not 
look through the system default file for specifications when you use the —n 


option, but will go directly to your .mailre file. This results in faster ini- 
tialization; substantially faster when the system is busy. 
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To send a message to another UNIX system user, enter the following com- 
mand: 


$ mailx daves<CR> 


The login name specified belongs to the person who is to receive the message. 
The system puts you into input mode and prompts you for the subject of the mes- 
sage. (You may have to wait a few seconds for the Subject: prompt if the sys- 
tem is very busy.) This is the simplest way to run the mailx command; it differs 
very little from the way you run the mail command. 


The following examples show how you can edit messages you are sending, 
incorporate existing text into your messages, change the header information, and 
perform other tasks that take advantage of the mailx command’s capabilities. 
Each example is followed by an explanation of the key points illustrated in the 
example. 


$ mailx daves<CR> 
Subject: 


Whether to include a subject or not is optional. If you elect not to, press the 
RETURN key. The cursor moves to the next line and the program waits for you 
to enter the text of the message. 
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$ mailx daves<CR> 

Subject: meeting<CR> 

We’re having a meeting for novice mailx users in<CR> 
the auditorium at 9:00 tomorrow. <<CR> 

Would you be willing to give a demonstration? <CR> 


Bob<CR> 
~ <CR> 
ce: <CR> 
$ 


There are two important things to notice about the above example: 


™ You break up the lines of your message by pressing the RETURN key at 
the end of each line. This makes it easier for the recipient to read the 
message, and prevents you from overflowing the line buffer. 


m@ You end the text and send the message by entering a tilde and a period 
together (~.) at the beginning of a line. The system responds with an end- 
of-text notice (KOT) and a prompt. 


There are several commands available to you when you are in input mode (as 
we were in the example). Each of them consists of a tilde (~), followed by an 
alphabetic character, entered at the beginning of a line. Together they are known 
as tilde escapes. (See the mailx(1) manual page in the User’s Reference 
Manual.) Most of them are used in the examples in this section. 


You can include the subject of your message on the command line by using 
the —s option. For example, the command line: 


$ mailx —s "meeting" daves<CR> 
is equivalent to: 


$ mailx daves<CR> 
Subject: meeting <CR> 
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The subject line will look the same to the recipient of the message. Notice 
that when putting the subject on the command line, you must enclose a subject 
that has more than one word in quotation marks. 


Editing the Message 


When you are in the input mode of mailx, you can invoke an editor by enter- 
ing the “e (tilde e) escape at the beginning of a line. The following example 
shows how to use tilde: 


$ mailx daves<CR> 

Subject: Testing my tilde<CR> 

When entering the text of a message<CR> 
that has somehow gotten grabled<CR> 
you may invoke your favorite editor<CR> 


by means of a “e (tilde e). 


Notice that you have misspelled a word in your message. To correct the error, 
use “e to invoke the editor, in this case the default editor, ed. 
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“e<CR> 

12 

/grabled/p 

that has somehow gotten grabled 
s/gra/gar/p 

that has somehow gotten garbled 


Ww 
132 

q 

(continue) 

What more can I tell you? 


In this example the ed editor was used. Your .profile or a .mailre file controls 
which editor will be invoked when you issue a ~e escape command. The ‘v (tilde 
v) escape invokes an alternate editor (most commonly, vi). 


When you exited from ed (by typing q), the mailx command returned you to 
input mode and prompted you to continue your message. At this point you may 
want to preview your corrected message by entering a “p (tilde p) escape. The “p 
escape prints out the entire message up to the point where the “p was entered. 
Thus, at any time during text entry, you can review the current contents of your 
message. 
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P 
Message contains: 
To: daves 


Subject: Testing my tilde 


When entering the text of a message 
that has somehow gotten garbled 
you may invoke your favorite editor 
by means of a tilde e (~e). 

What more can I tell you? 
(continue ) 


Incorporating Existing Text into Your Message 


mailx provides four ways to incorporate material from another source into the 
message you are creating. You can: 


m@ read a file into your message 

m™ read a message you have received into a reply 

M@ incorporate the value of a named environment variable into a message 

™ execute a shell command and incorporate the output of the command into 


a message 


The following examples show the first two of these functions. These are the 
most commonly used of these four functions. For information about the other 
two, see the mailx(1) manual page of the User’s Reference Manual. 
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Reading a File into a Message 


$ mailx daves<CR> 

Subject: Work Schedule<CR> 

As you can see from the following <CR> 
“r letters/filel 

"letters/file1" 10/725 

we have our work cut out for us. 


Please give me your thoughts on this. 
— Bob 


As the example shows, the “r (tilde r) escape is followed by the name of the 
file you want to include. The system displays the file name and the number of 
lines and characters it contains. You are still in input mode and can continue 
with the rest of the message. When the recipient gets the message, the text of 
letters/filel is included. (You can, of course, use the “p (tilde p) escape to pre- 
view the contents before sending your message.) 
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Incorporating a Message from Your Mailbox into a Reply 


$ mailx<CR> 

mailx version 2.14 2/9/85 Type ? for help. 

"usr/mail/roberts": 2 messages 1 new 

>N 1 abe Tue May 1 08:09 8/155 Meeting Notice 
2 hqtrs Mon Apr 30 16:57 4/127 Schedule 

? m jones<CR> 

Subject: Hq Schedule<CR> 

Here is a copy of the schedule from headquarters...<CR> 

“f 2<CR> 


Interpolating: 2 

(continue ) 

As you can see, the boss will be visiting our district on<CR> 
the 14th and 15th.<CR> 

— Robert 


There are several important points illustrated in this example: 


The sequence begins in command mode, where you read and respond to 
your incoming mail. Then you switch into input mode by issuing the com- 
mand m jones (meaning send a message to jones). 


The “f escape is used in input mode to call in one of the messages in your 
mailbox and make it part of the outgoing message. The number 2 after the 
“f means message 2 is to be interpolated (read in). 


mailx tells you that message 2 is being interpolated and then tells you to 
continue. 


When you finish creating and sending the message, you are back in com- 
mand mode, as shown by the ? prompt. You may now do something else 
in command mode, or exit mailx by typing q. 
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An alternate command, the “m (tilde m) escape, works the way that “f does 
except the read-in message is indented one tab stop. Both the “m and “f com- 
mands work only if you start out in command mode and then enter a command 
that puts you into input mode. Other commands that work this way will be 
covered in the section "How to Manage Incoming Mail." 


Changing Parts of the Message Header 
The header of a mailx message has four components: 
@ subject 
= recipient (s) 
@ copy-to list 


™ blind-copy list (a list of intended recipients that is not shown on the copies 
sent to other recipients) 


When you enter the mailx command followed by a login or an alias you are 
put into input mode and prompted for the subject of your message. Once you end 
the subject line by pressing the RETURN key, mailx expects you to type the text 
of the message. If, at any point in input mode, you want to change or supplement 
some of the header information, there are four tilde escapes that you can use: “h, 
“t, “ce, and °b. 


“h displays all the header fields: subject, recipient, copy-to list, and 
blind copy list, with their current values. You can change a current 
value, add to it, or, by pressing the RETURN key, accept it. 


“t lets you add names to the list of recipients. Names can be either 
login names or aliases. 

xe lets you create or add to a copy-to list for the message. Enter either 
login names or aliases of those to whom a copy of the message should 
be sent. 

“db lets you create or add to a blind-copy list for the message. 
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All tilde escapes must be in the first position on a line. For the “t, “ec or ‘b, 
any additional material on the line is taken to be input for the list in question. 
Any additional material on a line that begins with a ‘h is ignored. 


Adding Your Signature 


If you want, you can establish two different signatures with the sign and Sign 
environment variables. These can be invoked with the “a (tilde a) or “A (tilde A) 
escape, respectively. Assume you have set the value Supreme Commander to be 
called by the “A escape. Here’s how it would work: 


$ mailx —s orders all<CR> 

Be ready to move out at 0400 hours.<CR> 
“A<CR> 

Supreme Commander 


~<CR> 
EOT 
$ 


Having both escapes (“a and ~A) allows you to set up two forms for your sig- 
nature. However, because the sender’s login automatically appears in the message 
header when the message is read, no signature is required to identify you. 


Keeping a Record of Messages You Send 


The mailx command offers several ways to keep copies of outgoing messages. 
Two that you can use without setting any special environment variables are the “w 
(tilde w) escape and the —F option on the command line. 


The “w followed by a file name causes the message to be written to the named 
file. For example: 
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$ mailx bdr<CR> 

Subject: Saving Copies<CR> 

When you want to save a copy of <CR> 

the text of a message, use the tilde w.<CR> 
“w savemail 


"savemail" 2/71 


If you now display the contents of savemail, you will see this: 


$ cat savemail<CR> 
When you want to save a copy of 
the text of a message, use the tilde w. 


$ 


The drawback to this method, as you can see, is that none of the header informa- 
tion is saved. 


Using the —F option on the command line does preserve the header informa- 
tion. It works as follows: 
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$ mailx —F —s Savings bdr<CR> 
This method appends this message to a 
file in my current directory named bdr. 


HOT 
$ 


We can check the results by looking at the file bdr. 


$ cat bdr<CR> 

From: kol Fri May 2 11:14:45 1986 
To: bdr 

Subject: Savings 


This method appends this message to a 
file in my current directory named bdr. 
$ 


The —F option appends the text of the message to a file named after the first 
recipient. If you have used an alias for the recipient(s) the alias is first converted 
into the appropriate login(s) and the first login is used as the file name. As noted 
above, if you have a file by that name:in your current directory, the text of the 
message is appended to it. 
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Exiting from mailx 


When you have finished composing your message, you can leave mailx by typ- 
ing any of the following three commands: 


~~ 


tilde period (~.) is the standard way of leaving input mode. It also 
sends the message. If you entered input mode from the command 
mode of mailx, you now return to the command mode (as shown by 
the ? prompt you receive after typing this command). If you started 
out in input mode, you now return to the shell (as shown by the shell 
prompt). 


tilde q (“q) simulates an interrupt. It lets you exit the input mode of 
mailx. If you have entered text for a message, it will be saved in a 
file called dead.letter in your home directory. 


tilde x (“x) simulates an interrupt. It lets you exit the input mode of 
mailx without saving anything. 


Summary 


482 


In the preceding paragraphs we have described and shown examples of some 
of the tilde escape commands available when sending messages via the mailx com- 
mand. (See the mailx(1) manual page in the User’s Reference Manual.) 


. USER’S GUIDE 


How to Manage Incoming Mail 


mailx has over fifty commands which help you manage your incoming mail. 
See the mailx(1) manual page in the User’s Reference Manual for a list of all of 
them (and their synonyms) in alphabetic order. The most commonly used com- 
mands (and arguments) are described in the following subsections: 


the msglist argument 


commands for reading and deleting mail 


commands for saving mail 


commands for replying to mail 


commands for getting out of mailx 


The msglist Argument 


Many commands in mailx take a form of the msglist argument. This argu- 


ment provides the command with a list of messages on which to operate. Ifa 


command expects a msglist argument and you do not provide one, the command 
is performed on the current message. Any of the following formats can be used 
for a msglist: 


n 


A 


$ 

* 

n-m 
user 
/string 


2C 


message number n the current message 

the first undeleted message 

the last message 

all messages 

an inclusive range of message numbers 

all messages from user 

all messages with string in the subject line (case is ignored) 
all messages of type c where c is: 


d - deleted messages 
n - new messages 

o - old messages 

r - read messages 

u - unread messages 
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The context of the command determines whether this type of specification makes 
sense. 


Here are two examples (the ? is the command mode prompt): 


? d1-3 [ Delete messages 1, 2 and 3 | 
? s bdr bdr [ Save all messages from user bdr in a 
file named bdr. | 


Additional examples may be found throughout the next three subsections. 


Commands for Reading and Deleting Mail 
When a message arrives in your mailbox the following notice appears on your 
screen: 


you have mail 


The notice appears when you log in or when you return to the shell from another 
procedure. 


Reading Mail 


To read your mail, enter the mailx command with or without arguments. 
Execution of the command places you in the command mode of mailx. The next 
thing that appears on your screen is a display that looks something like this: 


484 USER’S GUIDE 


How to Manage Incoming Mail 


mailx version 2.14 10/19/86 Type ? for help 
"/usr/mail/bdr": 3 messages 3 new 
> N 1 rbt Thur Apr 30 14:20 8/190 Review Session 


N 2 admin Thur Apr 30 15:56 5/84 New printer 


N 3 daves Fri May 1 08:39 64/1574 Reorganization 
? 


The first line identifies the version of mailx used on your system, displays the 
date, and reminds you that help is available by typing a question mark (?). The 
second line shows the path name of the file used as input to the display (the file 
name is normally the same as your login name) together with a count of the total 
number of messages and their status. The rest of the display is header informa- 
tion from the incoming messages. The messages are numbered in sequence with 
the last one received at the bottom of the list. To the left of the numbers there 
may be a status indicator; N for new, U for unread. A greater than sign (>) 
points to the current message. Other fields in the header line show the login of 
the originator of the message, the day, date and time it was delivered, the number 
of lines and characters in the message, and the message subject. The last field 
may be blank. 


When the header information is displayed on your screen, you can print mes- 
sages either by pressing the RETURN key or entering a command followed by a 
msglist argument. If you enter a command with no msglist argument, the com- 
mand acts on the message pointed at by the > sign. Pressing the RETURN key 
is the equivalent of a typing the p (for print) command without a msglist argu- 
ment; the message displayed is the one pointed at by the > sign. To read some 
other message (or several others in succession), enter a p (for print) or t (for 
type) followed by the message number(s). Here are some examples: 
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? <CR> [ Print the current message. ] 
? p2<CR> [ Print message number 2. ] 
? p daves<CR> { Print all messages from user daves. ] 


The command t (for type) is a synonym of p (for print). 


Scanning Your Mailbox 


The mailx command lets you look through the messages in your mailbox 
while you decide which ones need your immediate attention. 


When you first enter the mailx command mode, the banner tells you how 
many messages you have and displays the header line for twenty messages. (If 
you are dialed into the computer system, only the header lines for ten messages 
are displayed.) If the total number of messages exceeds one screenful, you can 
display the next screen by entering the z command. Typing z— causes a previous 
screen (if there is one) to be displayed. If you want to see the header information 
for a specific group of messages, enter the f (for from) command followed by the 
msglist argument. 


Here are examples of those commands: 


(ae 4 { Scroll forward one screenful of header lines. ] 
<a ae [ Scroll backward one screenful. ) 
? f daves [ Display headers of all messages from user daves. ] 
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Switching to Other Mail Files 


When you enter mailx by issuing the command: 
$ mailx<CR> 


you are looking at the file /usr/mail/your_ login. 


mailx lets you switch to other mail files and use any of the mailx commands on 
their contents. (You can even switch to a non-mail file, but if you try to use 
mailx commands you are told No applicable messages.) The switch to another 
file is done with the fi or fold command (they are synonyms) followed by the 
filename. The following special characters work in place of the filename argu- 
ment: 


% the current mailbox 


% login the mailbox of the owner of login (if you have the required permis- 


sions) 
# the previous file 
& the current mbox 


Here is an example of how this might look on your screen: 
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$ mailx<CR> 


mailx version 2.14 10/19/86 Type ? for help. 
"usr/mail/daves": 3 messages 2 new 3 unread 
U 1 jaf Sat May 9 07:55 7/137 test25 
> N 2 todd Sat May 9 08:59 9/377 UNITS requirements 
N 3 has Sat May 9 11:08 29/1214 access to bailey 


? fi & [ Enter this command to transfer to your mbox. J 


Held 3 messages in /usr/mail/daves 
"/£s1/daves/mbox": 74 messages 10 unread 


? q<CR> 
$ 


Deleting Mail 


To delete a message, enter a d followed by a msglist argument. If the 
msglist argument is omitted, the current message is deleted. The messages are 
not deleted until you leave the mailbox file you are processing. Prior to that, the 
u (for undelete) gives you the opportunity to change your mind. Once you have 
issued the quit command (q) or switched to another file, however, the deleted 
messages are gone. 


mailx permits you to combine the delete and print command and enter a dp. 
This is like saying, "Delete the message I just read and show me the next one." 
Here are some examples of the delete command: 
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[ Delete all my messages. } 
{ Delete all messages that have been read. | 
{ Delete the current message and print the next one. ] 


{ Delete messages 2 through 5. ] 


Commands for Saving Mail 


All messages not specifically deleted are saved when you quit mailx. Mes- 
sages that have been read are saved in a file in your home directory called mbox. 
Messages that have not been read are held in your mailbox 
(/usr/mail/your_ login). 


The command to save messages comes in two forms: with an upper case or a 
lower case s. The syntax for the upper case version is: 
S [msglist] 
Messages specified by the msglist argument are saved in a file in the current 
directory named for the author of the first message in the list. 
The syntax for the lower case version is: 
s [msglist] Lfilename] 
Messages specified by the msglist argument are saved in the file named in the 
filename argument. If you omit the msglist argument, the current message is 


saved. If you are using logins for file names, this can lead to some ambiguity. If 
mailx is puzzled, you will get an error message. 
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Commands for Replying to Mail 


The command for replying to mail comes in two forms: with an upper case or 
a lower case r. The principal difference between the two forms is that the upper 
case form (R) causes your response to be sent only to the originator of the mes- 
sage, while the lower case form (r) causes your response to be sent not only to the 
originator but also to all other recipients. (There are other differences between 
these two forms. For details, see the mailx(1) manual page in the User’s Refer- 
ence Manual.) 


When you reply to a message, the original subject line is picked up and used 
as the subject of your reply. Here’s an example of the way it looks: 


$ mailx<CR> 


mailx version 2.14 10/19/83 Type ? for help. 
"usr/mail/daves": 3 messages 2 new 3 unread 

U 1 jaf Wed May 9 07:55 7/137 test25 
> N 2 todd Wed May 9 08:59 9/377 #4UNITS requirements 


N 3 has Wed May 9 11:08 29/1214 access to bailey 


? R2 
To: todd 
Subject: Re: UNITS requirements 


Assuming the message about UNITS requirements had been sent to some addi- 
tional people, and the lower case r had been used, the header might have 
appeared like this: 
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?9r2 
To: todd eg has jcb hdr 
Subject: Re: UNITS requirements 


Commands for Getting Out of mailx 


There are two standard ways of leaving mailx: with a q or with an x. If you 
leave mailx with a q, you see messages that summarize what you did with your 


mail. They look like this: 


? q<CR> 
Saved 1 message in /fs1/bdr/mbox 
Held 1 message in /usr/mail/bdr 


$ 


From the example we can surmise that user bdr had at least two messages, 
read one and either left the other unread or issued a command asking that it be 
held in /usr/mail/bdr. If there were more than two messages, the others were 
deleted or saved in other files. mailx does not issue a message about those. 
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If you leave mailx with an x, it is almost as if you had never entered. Mail 
read and messages deleted are retained in your mailbox. However, if you have 
saved messages in other files, that action has already taken place and is not 
undone by the x. 


mailx Command Summary 


In the preceding subsections we have described some of the most frequently 
used mailx commands. (See the mailx(1) manual page in the User’s Reference 
Manual for a complete list.) If you need help while you are in the command 
mode of mailx, type either a ? or help after the ? prompt. A list of mailx com- 
mands and what they do will be displayed on your terminal screen. 
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The .mailre file contains commands to be executed when you invoke mailx. 


There may be a system-wide start-up file (/usr/lib/mailx/mailx.re) on your 
system. If it exists it is used by the system administrator to set common vari- 
ables. Variables set in your .mailrc file take precedence over those in mailx.re. 


Most mailx commands are legal in the .mailre file. However, the following 
commands are NOT legal entries: 


! (or) shell escape to the shell 


Copy save messages in msglist in a file whose name is derived 
from the author 


edit invoke the editor 

visual invoke vi 

followup respond to a message 

Followup respond to a message, sending a copy to msglist 
mail switch into input mode 

reply respond to a message 

Reply respond to the author of each message in msglist 


You can create your own .mailre with any editor, or copy a friend’s. Figure 
8-5 shows a sample .mailrc file. 
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if r 
cd $HOME/mail 
endif 
set allnet append asksub askcc autoprint dot 
set metoo quiet save showto header hold keep keepsave 
set outfolder 
set folder=’mail’ 
set record=’ outbox’ 
set crt=24 
set EDITOR=’/bin/ed’ 
set sign=’Roberts’ 
set Sign=’Jackson Roberts, Supervisor’ 
set toplines=10 
alias fred 
alias bob 
alias alice 
alias mark 
alias donna 
alias pat 
group robertsgrp fred bob alice pat mark 
group accounts robertsgrp donna 


Figure 8-5: Sample .mailre File 


The example in Figure 8-5 includes the commands you are most likely to find 
useful: the set command and the alias or group commands. 


The set command is used to establish values for environment variables. The 
command syntax is: 


set 

set name 

set name = String 
set name = number 


494  USER’S GUIDE 


mailx 


When you issue the set command without any arguments, set produces a list 
of all defined variables and their values. The argument name refers to an envi- 
ronmental variable. More than one name can be entered after the set command. 
Some variables take a string or numeric value. String values are enclosed in sin- 
gle quotes. 


When you put a value in an environment variable by making an assignment 
such as HOME=my login, you are telling the shell how to interpret that variable. 
However, this type of assigment in the shell does not make the value of the vari- 
able accessible to other UNIX system programs that need to reference environ- 
ment variables. To make it accessible, you must export the variable. If you set 
the TERM variable in your environment in Chapter 6 or Chapter 7, you will 
remember using the export command as shown in the following example: 


$ TERM =5425 
$ export TERM 


When you export variables from the shell in this way, programs that refer- 
ence environment variables are said to import them. Some of these variables 
(such as EDITOR and VISUAL) are not peculiar to mailx, but may be specified 
as general environment variables and imported from your execution environment. 
If a value is set in .mailre for an imported variable it overrides the imported 
value. There is an unset command, but it works only against variables set in 
-mailre; it has no effect on imported variables. 


There are forty-one environment variables that can be defined in your .mailrc; 
too many to be fully described in this document. For complete information, con- 
sult the mailx(1) manual page in the User’s Reference Manual. 


Three variables used in the example in Figure 8-5 deserve special attention 
because they demonstrate how to organize the filing of messages. These variables 
are: folder, record, and outfolder. All three are interrelated and control the 
directories and files in which copies of messages are kept. 


To put a value into the folder variable, use the following format: 
set folder = directory 


This specifies the directory in which you want to save standard mail files. If the 
directory name specified does not begin with a / (slash), it is presumed to be rela- 
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tive to SHOME. If folder is an exported shell variable, you can specify file names 
(in commands that call for a filename argument) with a / before the name; the 
name will be expanded so that the file is put into the folder directory. 


To put a value in the record variable, use the following format: 
set record = filename 


This directs mailx to save a copy of all outgoing messages in the specified file. 
The header information is saved along with the text of the message. By default, 
this variable is disabled. 


The outfolder variable causes the file in which you store copies of outgoing 
messages (enabled by the variable record =) to be located in the folder directory. 
It is established by being named in a set command. The default is nooutfolder. 


The alias and group commands are synonyms. In Figure 8-5, the alias com- 
mand is used to associate a name with a single login; the group command is used 
to specify multiple names that can be called in with one pseudonym. This is a 
nice way to distinguish between single and group aliases, but if you want, you can 
treat the commands as exact equivalents. Notice, too, that aliases can be nested. 


In the .mailre file shown in Figure 8-5, the alias robertsgroup represents five 
users; three of them are specified by previously defined aliases and one is specified 
by a login. The fifth user, pat, is specified by both a login and an alias. The next 
group command in the example, accounts, uses the alias robertsgroup plus the 
alias donna. It expands to twelve logins. 


The .mailrc file in Figure 8-5 includes an if-endif command. The full syntax 
of that command is: 


if s|r mail_ commands 
else mail_commands 


endif 


The s and r stand for send and receive, so you can cause some initializing com- 
mands to be executed according to whether mailx is entered in input mode (send) 
or command mode (receive). In the preceding example, the command is issued to 
change directory to SHOME/mail if reading mail. The user in this case had 
elected to set up a subdirectory for handling incoming mail. 
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The environment variables shown in this section are those most commonly 
included in the .mailrc file. You can, however, specify any of them for one session 
only whenever you are in command mode. For a complete list of the environment 
variables you can set in mailx see the mailx(1) manual page in the User’s Refer- 
ence Manual. 
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This section describes the commands available for transferring files: the mail 
command for small files (a page or less), and the uucp and uuto commands for 
long files. The mail command can be used for transferring a file either within a 
local system or to a remote system. The uucp and uuto commands transfer files 
from one system to another. 


Sending Small Files: the mail Command 


To send a file in a mail message, you must redirect the input to that file on 
the command line. Use the < (less than) redirection symbol as follows: 


mail login < filename<CR> 


(For further information on input redirection, see Chapter 7.) Here login is the 
recipient’s login ID and filename is the name of the file you want to send. For 
example, to send a copy of a file called agenda to the owner of login sarah (on 
your system) type the following command line: 


$ mail sarah < agenda<CR> 
$ 


The prompt that appears on the second line means the contents of agenda have 
been sent. When sarah issues the mail command to read her messages, she will 
receive agenda. 


To send the same file to more than one user on your system, use the same 
command line format with one difference; in place of one login ID, type several, 
separated by spaces. For example: 


$ mail sarah tommy dingo wombat < agenda<CR> 
$ 


Again, the prompt returned by the system in response to your command is a sig- 
nal that your message has been sent. 


The same command line format, with one addition, can also be used to send a 
file to a user on a remote system that can communicate with yours. In this case, 
you must specify the name of the remote system before the user’s login name. 
Separate the system name and the login name with an ! (exclamation point): 
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mail system!login < filename<CR> 
For example: 


$ mail dumbo!wombat < agenda<CR> 
$ 


The system prompt on the second line means that your message (containing the 
file) has been queued for sending. 


If you are using mailx, you cannot use the mail command line syntax to send 
a file. Instead, you use the ‘r option as follows: 


$ mailx phyllis 
Subject: Memo 
“TY memo 


$ 


Sending Large Files 


The uucp and uuto commands allow you to transfer files to a remote com- 
puter. uucp allows you to send files to the directory of your choice on the destina- 
tion system. If you are transferring a file to a directory that you own, you will 
have permission to put the file in that directory. (See Chapter 3 for information 
on directory and file permissions.) However, if you are transferring the file to 
another user’s directory, you must be sure, in advance, that the user has given you 
permission to write a file to his or her directory. In addition, because you must 
specify path names that are often long and accuracy is required, uucp command 
lines may be cumbersome and lead to error. 
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The uuto command is an enhanced version of uucp. It automatically sends 
files to a public directory on the recipient’s system called /usr/spool/uucppublic. 
This means you cannot choose a destination file. However, it also means that you 
can transfer a file at any time without having to request write permission from the 
owner of the destination directory. Finally, the uuto command line is shorter and 
less complicated than the uucp command line. When you type a uuto command 
line, the likelihood of making an error is greatly reduced. 


Getting Ready: Do You Have Permission? 


Before you actually send a file with the uucp or uuto command, you need to 
find out whether or not the file is transferable. To do that, you must check the 
file’s permissions. If they are not correct, you must use the chmod command to 
change them, if you own the files. (Permissions and the chmod command are 
covered in Chapter 3.) 


There are two permission criteria that must be met before a file can be 
transferred using uucp or uuto. 


m The file to be transferred must have read permission (r) for others. 
= The directory that contains the file must have read (r) and execute (x) 


permission for others. 


For example, assume that you have a file named chicken, under a directory 
named soup (in your home directory). You want to send a copy of the chicken 
file to another user with the uuto command. First, check the permissions on soup: 


$ ls -1<CR> 
total 4 
Orwxr-xr-x 2 reader group1 45 Feb 9 10:43 soup 


$ 
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The response of the Is command shows that soup has read (r) and execute (x) 
permissions for all three groups; no changes have to be made. Now use the cd 
command to move from your home directory to soup, and check the permissions 
on the file chicken: 


$ Is —I chicken<CR> 


1 reader group1 3101 Mar 1 18:22 chicken 


The command’s output means that you (the user) have permission to read the file 
chicken, but no one else does. To add read permissions for your group (g) and 
others (0), use the chmod command: 


$ chmod go +r chicken<CR> 


Now check the permissions again with the Is —] command: 


$ Is —l chicken<CR> 
total 4 
-Yw-L--r-- 4 reader groupt 3101 Mar01 18:22 chicken 


$ 


This confirms that the file is now transferable; you can send it with the uucp or 
uuto command. After you send copies of the file, you can reverse the procedure 
and replace the previous permissions. 
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The uucp Command 


The command uuep (short for UNIX-to-UNIX system copy) allows you to 
copy a file directly to the home directory of a user on another computer, or to any 
other directory you specify and for which you have write permission. 


uucp is not an interactive command. It performs its work silently, invisible to 
the user. Once you issue this command you may run other processes. 


Transferring a file between computers is a multiple-step procedure. First, a 
work file, containing instructions for the file transfer, must be created. When 
requested, a data file (a copy of the file being sent) is also made. Then the file is 
ready to be sent. When you issue the uucp command, it performs the preliminary 
steps described above (creating the necessary files in a dedicated directory called 
a spool directory), and then calls the uucico daemon that actually transfers the 
file. (Daemons are system processes that run in background.) The file is placed in 
a queue and uucico sends it at the first available time. 


Thus, the uucp command allows you to transfer files to a remote computer 
without knowing anything except the name of the remote computer and, possibly, 
the login ID of the remote user(s) to whom the file is being sent. 


Command Line Syntax 


uucp allows you to send: 
™ one file to a file or a directory or 


# multiple files to a directory 


To deliver your file(s), uucp must know the full path name of both the source-file 
and the destination-file. However, this does not mean you must type out the full 
path name of both files every time you use the uucp command. There are several 

abbreviations you can use once you become familiar with their formats; uucp will 
expand them to full path names. 
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To choose the appropriate designations for your source-file and destination- 
file, begin by identifying the source-file’s location relative to your own current 
location in the file system. (We’ll assume, for the moment, that the source-file is 
in your local system.) If the source-file is in your current directory, you can 
specify it by its name alone (without a path). If the source-file is not in your 
current directory, you must specify its full path name. 


How do you specify the destination-file? Because it is on a remote system, 
the destination-file must always be specified with a path name that begins with 
the name of the remote system. After that, however, uucp gives you a choice: 
you can specify the full path or use either of two forms of abbreviation. Your 
destination-file should have one of the following three formats: 


mM system_namelfull_ path 

m@ system_name! login namel/directory_name/filename] 

B systemname\/login namel/directory_name/filename] 
The login name, in this case, belongs to the recipient of the file. 


Until now we have described what to do when you want to send a file from 
your local system to a remote system. However, it is also possible to use uucp to 
send a file from a remote system to your local system. In either case, you can use 
the formats described above to specify either source-files or destination-files. 

The important distinction in choosing one of these formats is not whether a file is 
a source-file or a destination-file, but where you are currently located in the file 
system relative to the files you are specifying. Therefore, in the formats shown 
above, the /Jogin_ name could refer to the login of the owner or the recipient of 
either a source-file or a destination-file. 


For example, let’s say you are login kol on a system called mickey. Your 
home directory is /usr/kol and you want to send a file called chap1 (in a directory 
called text in your home directory) to login wsm on a system called minnie. You 
are currently working in /usr/kol/text, so you can specify the source-file with its 
relative path name, chap1. Specify the destination-file in any of the ways shown 
in the following command lines: 


m@ Specify the destination-file with its full path name: 
uucp chap1 minnie! /usr/wsm/receive/chap1 


m™ Specify the destination-file with “login name (which expands to the name 
of the recipient’s home directory) and a name for the new file. 


uucp chap1 minnie!“wsm/receive/chap1 
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(The file will go to minnie! /usr/wsm/receive/chap1.) 


m Specify the destination-file with “login name (which expands to the 
recipient’s home directory) but without a name for the new file; uucp will 
give the new file the same name as the source-file. 


uucp chap1 minnie!“wsm/receive 
(The file will go to minnie! /usr/wsm/receive/chap1.) 


= Specify the destination-file with ~/login name. This expands to the 
recipient’s subdirectory in the public directory on the remote system. 


uucp chap1 minnie!~/wsm 


(The file will go to minnie! /usr/usr/spool/uucppublic/wsm) 


Sample Usage of Options with the uucp Command 


Suppose you want to send a file called minutes to a remote computer named 
eagle. Enter the command line shown in the following screen: 


$ uucp —m —s status —j minutes eagle! /usr/gws/minutes <CR> 
eagleN3£45 
$ 


This sends the file minutes (located in your current directory on your local com- 
puter) to the remote computer eagle, and places it under the path name /usr/gws 
in a file named minutes. When the transfer is complete, the user gws on the 
remote computer is notified by mail. 
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The —m option ensures that you (the sender) are also notified by mail as to 
whether or not the transfer has succeeded. The —s option, followed by the name 
of the file (status), asks the program to put a status report of the file transfer in 
the specified file (status). 


Be sure to include a file name after the —s option. If you do not, you will get this 
NOTE message: uucp failed completely. 
The job ID (eagleN3£45) is displayed in response to the —j option. 


Even if uucp does not notify you of a successful transfer soon after you send a 
file, do not assume that the transfer has failed. Not all systems equipped with 
networking software have the hardware needed to call other systems. Files being 
transferred from these so called passive systems must be collected periodically by 
active systems equipped with the required hardware (see "How the uucp Com- 
mand Works" for details). Therefore, if you are transferring files from a passive 
system, you may experience some delay. Check with your system administrator to 
find out whether your system is active or passive. 


The previous example uses a full path name to specify the destination-file. 
There are two other ways the destination-file can be specified: 


m The login directory of gws can be specified through use of the ~ (tilde), as 
shown below: 


eagle! ~gws/minutes 
is interpreted as: 
eagle! /usr/gws/minutes 
= The uucppublic area is referenced by a similar use of the tilde prefix to the 
path name. For example: 
eagle! ~ /gws/minutes 
is interpreted as: 


/usr/spool/uucppublic/gws/minutes 
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How the uucp Command Works 


This section is an overview of what happens when you issue the uucp com- 
mand. An understanding of the processes involved may help you to be aware of 
the command’s limitations and requirements: why it can perform some tasks and 
not others, why it performs tasks when it does, and why you may or may not be 
able to use it for tasks that uucp performs. For further details see the System 
Administrator’s Guide and the System Administrator’s Reference Manual. 


When you enter a uucp command, the uucp program creates a work file and 
usually a data file for the requested transfer. (uucp does not create a data file 
when you use the —e option.) The work file contains information required for 
transferring the file(s). The data file is simply a copy of the specified source file. 
After these files are created in the spool directory, the uucico daemon is started. 


The uucico daemon attempts to establish a connection to the remote computer 
that is to receive the file(s). It first gathers the information required for establish- 
ing a link to the remote computer from the Systems file. This is how uucico 
knows what type of device to use in establishing the link. Then uucico searches 
the Devices file looking for the devices that match the requirements listed in the 
Systems file. After uucico finds an available device, it attempts to establish the 
link and log in on the remote computer. 


When uucico logs in on the remote computer, it starts the uucico daemon on 
the remote computer. The two uucico daemons then negotiate the line protocol to 
be used in the file transfer(s). The local uucico daemon then transfers the file(s) 
that you are sending to the remote computer; the remote uucico places the file in 
the specified path name(s) on the remote computer. After your local computer 
completes the transfer(s), the remote computer may send files that are queued for 
your local computer. The remote computer can be denied permission to transfer 
these files with an entry in the Permissions file. If this is done, the remote com- 
puter must establish a link to your local computer to perform the transfers. 
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If the remote computer or the device selected to make the connection to the 
remote computer is unavailable, the request remains queued in the spool directory. 
Each hour (default), wudemon.hour is started by cron which in turn starts the 
uusched daemon. When the uusched daemon starts, it searches the spool directory 
for the remaining work files, generates the random order in which these requests 
are to be processed, and then starts the transfer process (uucico) described in the 
previous paragraphs. 


The transfer process described generally applies to an active computer. An 
active computer (one with calling hardware and networking software) can be set 
up to poll a passive computer. Because it has networking software, a passive com- 
puter can queue file transfers. However, it cannot call the remote computer 
because it does not have the required hardware. The Poll file 
(/usr/lib/uucp/Poll) contains a list of computers that are to be polled in this 
manner. 


Figure 8-6 summarizes the syntax and capabilities of the uucp command. 
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Command Recap 


uucp — copies a file from one computer to another 
command options arguments 


—jl, —m, —s and others* source-file 


Description: uucp performs preliminary tasks required to copy 
a file from one computer to another, and calls 


uucico, the daemon (background process) that 
transfers the file. The user need only issue the 
uucp command for a file to be copied. 


Remarks: By default, the only directory to which you can 
write files is /usr/spool/uucppublic. To write to 
directories belonging to another user, you must 
receive write permission from that user. Although 
there are several ways of representing path names 
as arguments, it is recommended that you type 
full path names to avoid confusion. 


Figure 8-6: Summary of the uucp Command 


. See the uucp(1) manual page in the User’s Reference Manual for all 


available options and an explanation of their capabilities. 
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The uuto Command 
The uuto command allows you to transfer files to the public directory of 
another system. The basic format for the uuto command is: 
uuto filename system\login<CR> 


where filename is the name of the file to be sent, system is the recipient’s system, 
and /ogin is the recipient’s login name. 


If you send a file to someone on your local system, you may omit the system 
name and use the following format: | 


uuto filename login<CR> 


Sending a File: the —m Option and uustat Command 


Now that you know how to determine if a file is transferable, let’s take an 
example and see how the whole thing works. 


The process of sending a file by uuto is referred to as a job. When you issue 
a uuto command, your job is not sent immediately. First, the file is stored in a 
queue (a waiting line of jobs) and assigned a job number. When the job’s 
number comes up, the file is transmitted to the remote system and placed in a 
public directory there. The recipient is notified by a mail message and must use 
the uupick command (discussed later in the chapter) to retrieve the file. 


For the following discussions, assume this information: 


wombat your login name 


sysl your system name 
marie recipient’s login name 
sys2 recipient’s system name 
money file to be sent 


Also assume that the two systems can communicate with each other. 
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To send the file money to login marie on system sys2, enter the following: 


$ uuto money sys2!marie<CR> 
$ 


The prompt on the second line is a signal that the file has been sent to a job 
queue. The job is now out of your hands; all you can do is wait for confirmation 
that the job reached its destination. 


How do you know when the job has been sent? The easiest method is to alter 
the uuto command line by adding a —m option, as follows: 


$ uuto —m money sys2!marie<CR> 


$ 


This option sends a mail message back to you when the job has reached the 
recipient’s system. The message may look something like this: 


$ mail<CR> 

From uucp Thur Apr3 09:45 EST 1986 
file /sys1/wombat/money, system sys1 
copy succeeded 


rg 


If you would like to check if the job has left your system, you can use the uustat 
command. This command keeps track of all the uucp and uuto jobs you submit 
and reports the status of each on demand. For example: 
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$ uustat<CR> 


1145 wombat sys2 10/05-09:31 10/05-09:33 JOB IS QUEUED 
$ 


The elements of this sample status message are as follows: 


m 1145 is the job number assigned to the job of sending the file money to 
marie on sys2. 


™ wombat is the login name of the person requesting the job. 
™ sys2 is the recipient’s system. 


10/05-09: 31 is the date and time the job was queued. 


10/05-09: 33 is the date and time this uustat message was sent. 


The final part is a status report on the job. Here the report shows that the 
job has been queued, but has not yet been sent. 


To receive a status report on only one uuto job, use the —j option and specify 
the job number on the command line: 


uustat —j jobnumber <CR> 


For example, to get a report on the job described in the previous example, specify 
1145 (the job number) after the —j option: 
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$ uustat —j1145<CR> 


1145 wombat sys2 10/05-09:31 10/05-09:37 COPY FINISHED,JOB DELETED 
$ 


This status report shows that the job was sent and deleted from the job queue; it 
is now in the public directory of the recipient’s system. Other status messages 
and options for the uustat command are described in the User’s Reference 
Manual. 


That is all there is to sending files. To practice, try sending a file to yourself. 


Figures 8-7 and 8-8 summarize the syntax and capabilities of the uuto and 
uustat commands, respectively. 
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Command Recap 


uuto — sends files to another login 
command options arguments 


uuto —m and others* file system!login 


Description: uuto sends a specified file to the public directory 


of a specified system, and notifies the intended 
recipient (by mail addressed to his or her login) 
that the file has arrived there. 


Remarks: Files to be sent must have read permission for 
others; the file’s parent directory must have read 
and execute permissions for others. 


The —m option notifies the sender by mail when 
the file has arrived at its destination. 


Figure 8-7: Summary of the uuto Command 


* See the uuto(1) manual page in the User’s Reference Manual for all 


available options and an explanation of their capabilities. 
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Command Recap © 


uustat — checks job status of a uucp or uuto job 
command options arguments 


uustat —j and others* none 


Description: uustat reports the status of all uucp and uuto jobs 
you have requested. 


Remarks: The —j option, followed by a job number, allows 
you to request a status report on only the specified 
job. 


Figure 8-8: Summary of the uustat Command 


* See the uustat(1) manual page in the User’s Reference Manual for all 


available options and an explanation of their capabilities. 


Receiving Files Sent with uuto: the uupick Command 


When a file sent by uuto reaches the public directory on your UNIX system, 
you receive a mail message. To continue the previous example, the owner of login 
marie receives the following mail message when the file money has arrived in her 
system’s public directory: 
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$ mail 
From uucp Wed May 14 09:22 EST 1986 
/usr/spool/uucppublic/receive/marie/sys1//money from sys1!wombat arrived 


$ 


The message contains the following pieces of information: 
™ The first line tells you when the file arrived at its destination. 


= The second line, up to the two slashes (//), gives the path name to the 
part of the public directory where the file has been stored. 


m™ The rest of the line (after the two slashes) gives the name of the file and 
the sender. 


Once you have disposed of the mail message, you can use the uupick com- 
mand to store the file where you want it. Type the following command after the 
system prompt: 


uupick <CR> 


The command searches the public directory for any files sent to you. If it finds 
any, it reports the filename(s). It then prints a ? prompt as a request for further 
instructions from you. 


For example, say the owner of login marie issues the uupick command to 
retrieve the money file. The command will respond as follows: 


$ uupick<CR> 
from system sys1: file money 
? 


There are several available responses; we will look at the most common responses 
and what they do. 
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The first thing you should do is move the file from the public directory and 
place it in your login directory. To do so, type an m after the question mark: 


? 
m<CR> 
$ 


This response moves the file into your current directory. If you want to put it in 
some other directory instead, follow the m response with the directory name: 


? 
m other _directory<CR> 


If there are other files waiting to be moved, the next one is displayed, followed by 
the question mark. If not, uucpick returns a prompt. 


If you do not want to do anything to that file now, press the RETURN key 
after the question mark: 


? 
<CR> 


The current file remains in the public directory until the next time you use the 
uupick command. If there are no more messages, the system returns a prompt. 


If you already know that you do not want to save the file, you can delete it by 
typing d after the question mark: 


? 
d<CR> 


This response deletes the current file from the public directory and displays the 
next message (if there is one). If there are no additional messages about waiting 
files, the system returns a prompt. 


Finally, to stop the uupick command, type a q after the question mark: 


? 
q<CR> 


Any unmoved or undeleted files will wait in the public directory until the next 
time you use the uupick command. 
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Other available responses are listed in the User’s Reference Manual. 


Figure 8-9 summarizes the syntax and capabilities of the uupick command. 


Command Recap 


uupick — searches for files sent by uuto or uucp 
command options arguments 


uupick =S system name 


Description: uupick searches the public directory of your sys- 
tem for files sent by uuto or uucp. If any are 
found, the command displays information about 
the file and prompts you for a response. 


Remarks: The question mark (?) at the end of the message 
shows that a response is expected. A complete 
list of responses is given in the User’s Reference 
Manual. 


Figure 8-9: Summary of the uupick Command 
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Networking is the process of linking computers and terminals so that users 
may be able to: 


@ log in on a remote computer as well as a local one 


™ jog in and work on two computers in one work session (without alternately 
logging off one and logging in on the other) 


™ exchange data between computers 


The commands presented in this section make it possible for you to perform 
these tasks. The ct command allows you to connect your computer to a remote 
terminal that is equipped with a modem. The cu command enables you to con- 
nect your computer to a remote computer, and the uux command lets you run 
commands on a remote system, without being logged in on it. 


whether or not networking software is installed. If it is not installed on your sys- 
tem, you will receive a message such as the following when you type a networking 
command: 


som On some small computers, the presence of these commands may depend on 
NOTE 


cu: not found 


Check with your system administrator to verify the availability of networking 
commands on your UNIX system. 


Connecting a Remote Terminal: the ct Command 


The ct command connects your computer to a remote terminal equipped with 
a modem, and allows a user on that terminal to log in. To do this, the command 
dials the phone number of the modem. The modem must be able to answer the 
call automatically. When ct detects that the call has been answered, it issues a 
getty (login) process for the remote terminal and allows a user on it to log in on 
the computer. 
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This command can be useful when issued from the opposite end, that is, from 
the remote terminal itself. If you are using a remote terminal that is far from 
your computer and want to avoid long distance charges, you can use ct to have 
the computer place a call to your terminal. Simply call the computer, log in, and 
issue the ct command. The computer will hang up the current line and call your 
(remote) terminal back. 


If ct cannot find an available dialer, it tells you that all dialers are busy and 
asks if it should wait until one becomes available. If you answer yes, it asks how 
long (in minutes) it should wait for one. 


Command Line Format 


To execute the ct command, follow this format: 
ct [options] telnno<CR> 


The argument telno is the telephone number of the remote terminal. 


Sample Command Usage 


Suppose you are logged in on a computer through a local terminal and you 
want to connect a remote terminal to your computer. The phone number of the 
modem on the remote terminal is 932-3497. Enter this command line: 


ct —h —w5 —s1200 9 =9323497<CR> 


the phone number represent delays (the dashes are useful following a long dis- 


som The equal sign (=) represents a secondary dial tone, and dashes (—) following 
NOTE 
tance number). 


ct will call the modem, using a dialer operating at a speed of 1200 baud. Ifa 
dialer is not available, the —w5 option will cause ct to wait for a dialer for five 
minutes before quitting. The —h option tells ct not to disconnect the local termi- 
nal (the terminal on which the command was issued) from the computer. 
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Now imagine that you want to log in on the computer from home. To avoid 
long distance charges, use ct to have the computer call your terminal: 


ct —s1200 9 =9323497<CR> 


Because you did not specify the —w option, if no device is available, ct sends you 
the following message: 


1 busy dialer at 1200 baud Wait for dialer? 


If you type n (no), the ct command exits. If you type y (yes), et prompts you to 
specify how long ct should wait: 


Time, in minutes? 
If a dialer is available, ct responds with: 
Allocated dialer at 1200 baud. 


This means that a dialer has been found. In any case, ct asks if you want the line 
connecting your remote terminal to the computer to be dropped: 


Confirm hangup? 


If you type y (yes), you are logged off and et calls your remote terminal back 
when a dialer is available. If you type n (no), the ct command exits, leaving you 
logged in on the computer. 


Figure 8-10 summarizes the syntax and capabilities of the et command. 
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Command Recap 


ct — connect computer to remote terminal 
command options arguments 


ct —h, —w, —s and others* telno 


Description: ct connects the computer to a remote terminal 
and allows a user to log in from that terminal. 


Remarks: The remote terminal must have a modem capable 
of answering phone calls automatically. 


Figure 8-10: Summary of the ct Command 


- See the ct(1) manual page in the User’s Reference Manual for all avail- 


able options and an explanation of their capabilities. 


Calling Another UNIX System: the cu Command 


The cu command connects a remote computer to your computer and allows 
you to be logged in on both computers simultaneously. This means that you can 
move back and forth between the two computers, transferring files and executing 
commands on both, without dropping the connection. 


The method used by the cu command depends on the information you specify 
on the command line. You must specify the telephone number or system name of 
the remote computer. If you specify a phone number, it is passed on to the 
automatic dial modem. If you specify a system name, cu obtains the phone 
number from the Systems file. If an automatic dial modem is not used to estab- 
lish the connection, the line (port) associated with the direct link to the remote 
computer can be specified on the command line. 
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Once the connection is made, the remote computer prompts you to log in on 
it. When you have finished working on the remote terminal, log off it and ter- 
minate the connection by typing <~.>. You will still be logged in on the local 
computer. 


lost or corrupted during file transfers. After a transfer, you can check for loss of 
data by running the sum command or the Is —I1 command on the file that was sent 
and the file that was received. Both of these commands will report the total 
number of bytes in each file; if the totals match, your transfer was successful. 
The sum command checks more quickly and gives output that is easier to inter- 
pret. (See the sum(1) and the Is(1) manual pages in the User’s Reference 
Manual for details.) 


som The cu command is not capable of detecting or correcting errors; data may be 
NOTE 


Command Line Format 


To execute the cu command, follow this format: 
cu [options] telno | systemname<CR> 
The components of the command line are: 
telno the telephone number of a remote computer 

Equal signs (=) represent secondary dial tones and dashes (—) 
repreent four-second delays. 

systemname a system name that is listed in the Systems file. 
The cu command obtains the telephone number and baud rate 
from the Systems file and searches for a dialer. The —s, —n, 
and —1 options should not be used together with systemname. 


(To see the list of computers in the Systems file, run the 
uuname command.) 


Once your terminal is connected and you are logged in on the remote com- 
puter, all standard input (input from the keyboard) is sent to the remote com- 
puter. Figures 8-11 and 8-12 show the commands you can execute while con- 
nected to a remote computer through cu. 
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Run command locally and send its output to the 
remote system. 


Networking 
Terminate the link. 
~! Escape to the local computer without dropping 
the link. To return to the remote computer, type 
<“d> (control-d). 
Execute command on the local computer. 
~ %cd path 
~ % take from [to] 


Change the directory on the local computer where 
path is the path name or directory name. 


Copy a file named from (on the remote computer) 
to a file named to (on the local computer). If to 
is omitted, the from argument is used in both 
places. 


Copy a file named from (on the local computer) 
to a file named to (on the remote computer). If 
to is omitted, the from argument is used in both 
places. 


~%put from [to] 


Send a line beginning with ~ (~~...) to the 
remote computer. 


~ % break Transmit a BREAK to the remote computer (can 


also be specified as ~ %b). 


Figure 8-11: Command Strings for Use with cu (Sheet 1 of 2) 
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String Interpretation 


~%nostop | Turn off the handshaking protocol for the 
remainder of the session. This is useful when the 
remote computer does not respond properly to the 
protocol characters. 


~%debug | Turn the —d debugging option on or off (can also 
be specified as ~%d). 


Display the values of the terminal I/O 
(input/output) structure variables for your termi- 
nal (useful for debugging). 


ables for the remote communication line (useful 
for debugging). 


Display the values of the termio structure vari- 


Figure 8-12: Command Strings for Use with cu (Sheet 2 of 2) 


The use of ~ % put requires stty and cat on the remote computer. It also 
requires that the current erase and kill characters on the remote computer be 
identical to the current ones on the local computer. 
The use of ~ % take requires the existence of the echo and cat commands on the 
remote computer. Also, stty tabs mode should be set on the remote computer if 
tabs are to be copied without expansion. 
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Sample Command Usage 


Suppose you want to connect your computer to a remote computer called 
eagle. The phone number for eagle is 847—7867. Enter the following command 
line: 


cu —s1200 9=8477867<CR> 


The —s1200 option causes cu to use a 1200 baud dialer to call eagle. If the —s 
option is not specified, cu uses a dialer at the default speed, 300 baud. 


When eagle answers the call, cu notifies you that the connection has been 
made, and prompts you for a login ID: 


connected 
login: 
Enter your login ID and password. 

The take command allows you to copy files from the remote computer to the 
local computer. Suppose you want to make a copy of a file named proposal for 
your local computer. The following command copies proposal from your current 
directory on the remote computer and places it in your current directory on the 


local computer. If you do not specify a file name for the new file, it will also be 
called proposal. 


~ % take proposal <CR> 
The put command allows you to do the opposite: copy files from the local 


computer to the remote computer. Say you want to copy a file named minutes 
from your current directory on the local computer to the remote computer. Type: 


~ % put minutes minutes.9—18 <CR> 


In this case, you specified a different name for the new file (minutes.9-18). 
Therefore the copy of the minutes file that is made on the remote computer will 
be called minutes.9-18. 


Figure 8-13 summarizes the syntax and capabilities of the cu command. 
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Command Recap 


cu — connects computer to remote computer 


command options arguments 


cu —s and others* telno (or) systemname 


Description: cu connects your computer to a remote computer 
and allows you to be logged in on both simultane- 
ously. Once you are logged in, you can move 

between computers to execute commands and 

transfer files on each without dropping the link. 


Figure 8-13: Summary of the cu Command 


* See the cu(1) manual page in the User’s Reference Manual for all avail- 


able options and an explanation of their capabilities. 


Executing Commands on a Remote System: the uux 
Command 


The command uux (short for UNIX-to-UNIX system command execution) 
allows you to execute UNIX system commands on remote computers. It can 
gather files from various computers, execute a command on a specified computer, 
and send the standard output to a file on a specified computer. The execution of 
certain commands may be restricted on the remote machine. The command 
notifies you by mail if the command you have requested is not allowed to execute. 
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Command Line Format 


To execute the uux command, follow this format: 
uux [options] command-—string<CR> 


The command —string is made up of one or more arguments. All special shell 
characters (such as "<>|"") must be quoted either by quoting the entire 
command—string or quoting the character as a separate argument. Within the 
command-—string the command and file names may contain a system name! 
prefix. All arguments that do not contain a systemname are interpreted as com- 
mand arguments. A file name may be either a full path name or the name of a 
file under the current directory (on the local computer). 


Sample Command Usage 


If your computer is hard-wired to a larger host computer you can use uux to 
get printouts of files that reside on your computer by entering: 


pr minutes | uux —p host!Ip<CR> 


This command line queues the file minutes to be printed on the area printer of the 
computer host. 


Figure 8-14 summarizes the syntax and capabilities of the uuwx command. 
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Command Recap 


uux — executes commands on a remote computer 
command options arguments 


—1, —p, and others* command-string 


Description: uux allows you to run UNIX system commands 


on remote computers. It can gather files from 
various computers, run a command on a specified 
computer, and send the standard output to a file 
on a specified computer. 


Remarks: By default, users of the uux command have per- 
mission to run only the mail and mailx com- 
mands. Check with your system administrator to 
find out if users on your system have been granted 
permission to run other commands. 


Figure 8-14: Summary of the uux Command 


: See the uux(1) manual page in the User’s Reference Manual for all 


available options and an explanation of their capabilities. 
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A: SUMMARY OF THE FILE SYSTEM 


The UNIX System Files 


This appendix summarizes the description of the file system given in Chapter 
1 and reviews the major system directories in the root directory. 


File System Structure 


The UNIX System files are organized in a hierarchy; their structure is often 
described as an inverted tree. At the top of this tree is the root directory, the 
source of the entire file system. It is designated by a / (slash). All other direc- 
tories and files descend and branch out from root, as shown in Figure A-1. 


ei Jie iris 
BIE VAvAv, OO 


C) = Directories 
[ = Ordinary Files 


Figure A-1: Directory Tree from root \/, =Special Fites 


One path from root leads to your home directory. You can organize and 
store information in your own hierarchy of directories and files under your home 
directory. 
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Other paths lead from root to system directories that are available to all 
users. The system directories described in this book are common to all UNIX 
system installations and are provided and maintained by the operating system. 


In addition to this standard set of directories, your UNIX system may have 
other system directories. To obtain a listing of the directories and files in the root 
directory on your UNIX system, type the following command line: 


Is —I1 /<CR> 


To move around in the file structure, you can use path names. For example, 
you can move to the directory /bin (which contains UNIX system executable 
files) by typing the following command line: 


ed /bin<CR> 
To list the contents of a directory, issue one of the following command lines: 


Is<CR> for a list of file and directory names 
Is -1<CR> for a detailed list of file and 
directory names 


To list the contents of a directory in which you are not located, issue the Is 
command as shown in the following examples: 
Is /bin<CR> for a short listing 
Is —1 /bin<CR> for a detailed listing 


The following section provides brief descriptions of the root directory and the 
system directories under it, as shown in Figure A-1. 
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/bin 


Nib 


/dev 


/ete 
/tmp 


/usr 


The source of the file system (called root directory) 


Contains many executable programs and utilities, such as the fol- 
lowing: 


cat 
date 
login 


grep 
mkdir 
who 


Contains available program libraries and language libraries, such 
as 

libc.a system calls, standard I/O 

libm.a math routines and support for languages 


such as C, FORTRAN, and BASIC. 


Contains special files that represent peripheral devices, such as: 


console console 

Ip line printer 

ttyn user terminal (s) 
dsk/* disks 


Contains programs and data files for system administration 


Contains temporary files, such as the buffers created for editing a 
file 


Contains the following subdirectories which, in turn, contain the 


data listed below: 


news important news items 

mail electronic mail 

spool files waiting to be printed on the line 
printer 
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Basic UNIX System Commands 
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at 


banner 


batch 


cat 


Request that a command be run in background mode at a time 
you specify on the command line. If you do not specify a time, 
at(1) displays the job numbers of all jobs you have running in 
at(1), batch(1), or background mode. 


A sample format is: 


at 8:45am Jun 09<CR> 
command1<CR> 
command2<CR> 

<“d> 


If you use the at command 

without the date, 

the command executes within twenty-four hours 
at the time specified. 


Display a message (in words up to ten characters long) in large 
letters on the standard output. 


Submit command(s) to be processed when the system load is at 
an acceptable level. A sample format of this command is: 


batch<CR> 
command! <CR> 
command2<CR> 
<“d> 


You can use a shell script for a command in batch(1). 
This may be useful and timesaving if you have a set of commands 
you frequently submit using this command. 


Display the contents of a specified file at your terminal. To halt 
the output on an ASCII terminal temporarily, use <“s>; type 
<“q> to restart the output. To interrupt the output and return 
to the shell on an ASCII terminal, press the BREAK or 
DELETE key. 
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cd 


cp 


cut 


date 
diff 


echo 


ed 


grep 


kill 


lex 


Ip 


Ipstat 


Basic UNIX System Commands 


Change directory from the current one to your home directory. 
If you include a directory name, changes from the current direc- 
tory to the directory specified. By using a path name in place of 
the directory name, you can jump several levels with one com- 
mand. 


Copy a specified file into a new file, leaving the original file 
intact. 


Cut out specified fields from each line of a file. This command 
can be used to cut columns from a table, for example. 


Display the current date and time. 


Compare two files. The diff(1) command reports which lines are 
different and what changes should be made to the second file to 
make it the same as the first file. 


Display input on the standard output (the terminal), including 
the carriage return, and returns a prompt. 


Edit a specified file using the line editor. If there is no file by the 
name specified, the ed(1) command creates one. See Chapter 5 
for detailed instructions on using the ed(1) editor. 


Search a specified file(s) for a specified pattern and prints those 
lines that contain the pattern. If you name more than one file, 
grep(1) prints the file that contains the pattern. 


Terminate a background process specified by its process 
identification number (PID). You can obtain a PID by running 
the ps(1) command. 


Generate programs to be used in simple lexical analysis of text, 
perhaps as a first step in creating a compiler. See the User’s 
Reference Manual for details. 


Print the contents of a specified file on a line printer, giving you a 
paper copy of the file. 


Display the status of any requests made to the line printer. 
Options are available for requesting more detailed information. 
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Is 


mail 


mailx 


make 


mkdir 


mv 


nohup 


pg 


List the names of all files and directories except those whose 
names begin with a dot (.). Options are available for listing 
more detailed information about the files in the directory. (See 
the Is(1) entry in the User’s Reference Manual for details.) 


Display any electronic mail you may have received at your termi- 
nal, one message at a time. Each message ends with ? prompt; 
mail(1) waits for you to request an option such as saving, for- 
warding, or deleting a message. To obtain a list of the available 
options, type ?. 


When followed by a login name, mail(1) sends a message to the 
owner of that name. You can type as many lines of text as you 
want. Then type <“d> to end the message and send it to the 
recipient. Press the BREAK key to interrupt the mail session. 


mailx(1) is a more sophisticated, expanded version of electronic 
mail. 


Maintain and support large programs or documents on the basis 
of smaller ones. See the make(1) page in the User’s Reference 
Manual for details. 


Make a new directory. The new directory becomes a subdirec- 
tory of the directory in which you issue the mkdir command. To 
create subdirectories or files in the new directory, you must first 
move into the new directory with the ed command. 


Move a file to a new location in the file system. You can move a 
file to a new file name in the same directory or to a different 
directory. If you move a file to a different directory, you can use 
the same file name or choose a new one. 


Place execution of a command in the background, so it will con- 
tinue executing after you log off of the system. Error messages 
are placed in a file called nohup.out. 


Display the contents of a specified file on your terminal, a page at 
a time. After each page, the system pauses and waits for your 
instructions before proceeding. 
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pr 


ps 


pwd 


rm 


rmdir 


sort 


spell 


stty 


Basic UNIX System Commands 


Display a partially formatted version of a specified file at your 
terminal. The pr(1) command shows page breaks, but does not 
implement any macros supplied for text formatter packages. 


Display the status and number of every process currently run- 
ning. The ps(1) command does not show the status of jobs in the 
at(1) or batch(1) queues, but it includes these jobs when they are 
executing. 


Display the full path name of the current working directory. 


Remove a file from the file system. You can use metacharacters 
with the rm(1) command but should use them with caution; a 
removed file cannot be recovered easily. 


Remove a directory. You cannot be in the directory you want to 
delete. Also, the command will not delete a directory unless it is 
empty. Therefore, you must remove any subdirectories and files 
that remain in a directory before running this command on it. 
(See rm -r in the User’s Reference Manual for the ability to 
remove directories that are not empty.) 


Sort a file in ASCII order and displays the results on your termi- 
nal. ASCII order is as follows: 


1. numbers before letters 
2. upper case before lower case 
3. alphabetical order 


There are other options for sorting a file. For a complete list of 
sort(1) options, see the sort(1) page in the User’s Reference 
Manual. 


Collect words from a specified file and check them against a spel- 
ling list. Words not on the list or not related to words on the list 
(with suffixes, prefixes, and so on) are displayed. 


Report the settings of certain input/output options for your termi- 
nal. When issued with the appropriate options and arguments, 
stty(1) also sets these input/output option. (See the stty(1) 

entry in the User’s Reference Manual.) 
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uname 


uucp 


uuname 


uupick 


uustat 


uuto 


vi 


we 


who 


yacc 


Display the name of the UNIX system on which you are 
currently working. 


Send a specified file to another UNIX system. (See the uucp(1) 
page in the User’s Reference Manual for details.) 


- List the names of remote UNIX systems that can communicate 


with your UNIX system. 


Search the public directory for files sent to you by the uuto(1) 
command. If a file is found, uupick(1) displays its name and the 
system it came from, and prompts you (with a ?) to take action. 


Report the status of the uuto(1) command you issued to send 
files to another user. 


Send a specified file to another user. Specify the destination in 
the format system!login. The system must be on the list of sys- 
tems generated by the uuname(1) command. 


Edit a specified file using the vi(1) screen editor. If there is no 
file by the name you specify, vi(1) creates one. (See Chapter 6 
for detailed information on using the vi(1) editor.) 


Count the number of lines, words, and characters in a specified 
file and display the results on your terminal. 


Display the login names of the users currently logged in on your 
UNIX system. List the terminal address for each login and the 
time each user logged in. 


Impose a structure on the input of a program. See the User’s 
Reference Manual for details. 
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C: QUICK REFERENCE TO ed COMMANDS 


The ed Commands 


The general format for ed commands is: 


[address 1,address2]commandI[parameter]...<CR> 


where addressI and address2 denote line addresses and the parameters show the 
data on which the command operates. The commands appear on your terminal as 
you type them. You can find complete information on using ed commands in 
Chapter 5, "Line Editor Tutorial." 


The following is a glossary of ed commands. The commands are grouped 
according to function. 


Commands for Getting Started 


ed filename Accesses the ed line editor to edit a specified file. 


a 


Appends text after the current line. 

Ends the text input mode and returns to the command mode. 
Displays the current line. 

Deletes the current line. 

Moves down one line in the buffer. 

Moves up one line in the buffer. 


Writes the buffer contents to the file currently associated with the 
buffer. 


Ends an editing session. If changes to the buffer were not written 
to a file, a warning (?) is issued. Typing q a second time ends 
the session without writing to a file. 
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Line Addressing Commands 


1, 2, 3... Denotes line addresses in the buffer. 


Address of the current line in the buffer. 


= Displays the current line address. 

$ Denotes the last line in the buffer. 

; Addresses the first through the last line. 

: Addresses the current line through the last line. 

+x Relative address, determined by adding x to the current line 
number. 

—Xx Relative address, determined by subtracting x from the current 


line number. 


/abc Searches forward in the buffer and addresses the first line after 
the current line that contains the pattern abc. 


2abc Searches backward in the buffer and addresses the first line 
before the current line that contains the pattern abc. 


g/abc Addresses all lines in the buffer that contain the pattern abc. 
v/abc Addresses all lines in the buffer that do not contain the pattern 
abc. 
Display Commands 
p Displays the specified lines in the buffer. 
n Displays the specified lines preceded by their line addresses and a 
tab space. 
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Text Input 
a Enters text after the specified line in the buffer. 
i Enters text before the specified line in the buffer. 
c Replaces text in the specified lines with new text. 
4 When typed on a line by itself, ends the text input mode and 


returns to the command mode. 


Deleting Text 


d Deletes one or more lines of text (command mode). 
u Undoes the last command given (command mode). 
@ Deletes the current line (in text input mode) or a command line 


(in command mode). 


# or BACKSPACE 
Deletes the last character entered as text (in input mode). 
Substituting Text 


address1,address2s/old_text/new_text/command 
Substitutes new_text for old_text within the range of lines 
denoted by address1,address2 (which may be numbers, symbols, 
or text). The command may be g, I, n, p, or gp. 


Special Characters 


Matches any single character in search or substitution patterns. 


+ Matches zero or more occurrences of the preceding character in 
search or substitution patterns. 

[...] Matches the first occurrence of a pattern in the brackets. 

[*...] Matches the first occurrence of a character that is not in the 
brackets. 
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* Matches zero or more occurrences of any characters following 
the period in search or substitution patterns. 


The circumflex (*) matches the beginning of the line in search or 
substitution patterns. 


$ Matches the end of the line in search or substitution patterns. 

\ Takes away the special meaning of the special character that fol- 
lows in search and substitution patterns. 

& Repeats the last pattern to be substituted. 

%o Repeats the last replacement pattern. 


Text Movement Commands 


m Moves the specified lines of text after a destination line; deletes 
the lines at the old location. 


t Copies the specified lines of text and places the copied lines after 
a destination line. 

j Joins the current line with the next contiguous line. 

Ww Copies (writes) the buffer contents into a file. 

r Reads in text from another file and appends it to the buffer. 


Other Useful Commands and Information 


h Displays a short explanation for the preceding diagnostic response 
(2). 

H Turns on the help mode, which automatically displays an 
explanation for each diagnostic response (?) during the editing 
session. 

| Displays nonprinting characters in the text. 

f Displays the current file name. 
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f newfile | Changes the current file name associated with the buffer to 
newfile. 


!command_ Allows you to escape, temporarily, to the shell to execute a shell 
command. 


ed.hup If the terminal is hung up before a write command, the editing 
buffer is saved in the file ed. hup. 
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vi Quick Reference 


This appendix is a glossary of commands for the screen editor vi. The com- 
mands are grouped according to function. 


The general format of a vi command is: 
[x]lcommand]text-object 


where x denotes a number and text-object shows the portion of text on which the 
command operates. The commands appear on your screen as you type them. For 
an introduction to the use of vi commands, see Chapter 6, "Screen Editor 
Tutorial." 


Commands for Getting Started 


Shell Commands 


TERM = code Puts a code name for your terminal into the variable 
TERM. 


export TERM Conveys the value of TERM (the terminal code) to any 
UNIX system program that is terminal dependent. 


tput init Initializes the terminal so that it will function properly 
with various UNIX system programs. 


above three lines: setting the TERM variable, exporting the value of TERM, and 


Before you can use vi, you must complete the first three steps represented by the 
NOTE 
running the tput init command. 


vi filename Accesses the vi screen editor so that you can edit a 
specified file. 
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<a> 
<ESC> 


<h> 
<j> 
<k> 
<I> 


vi Quick Reference 


Enters text input mode and appends text after the cursor. 


Escape; leaves text input mode and returns to command 
mode. 


Moves the cursor to the left one character. 

Moves the cursor down one line in the same column. 
Moves the cursor up one line in the same column. 
Moves the cursor to the right one character. 

Deletes the current character. 


Carriage return; moves the cursor down to the beginning 
of the next line. 


Writes changes made to the buffer to the file and quits 
vi. 


Writes changes made to the buffer to the file. 


Quits vi if changes made to the buffer have been written 
to a file. 


Commands for Positioning in the Window 


Positioning by Character 


<h> 


Moves the cursor one character to the left. 


<BACKSPACE> Backspace; moves the cursor one character to the left. 


<I> 
<space bar> 
<fx> 


Moves the cursor one character to the right. 
Moves the cursor one character to the right. 


Moves the cursor right to the specified character x. 
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<Fx> 
<tx> 


<Tx> 


<j3> 


Positioning by Line 


<j> 


<k> 


Positioning by Word 


<w> 


<b> 
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Moves the cursor left to the specified character x. 


Moves the cursor right to the character just before the 
specified character x. 


Moves the cursor left to the character just after the 
specified character x. 


Continues the search for the character specified by the 
<f>, <F>, <t>, or <T> commands. The; 
remembers the character specified and searches for the 
next occurrence of it on the current line. 


Continues the search for the character specified by the 
<f>, <F>, <t>, or <T> commands. The, 
remembers the character specified and searches for the 
previous occurrence of it on the current line. 


Moves the cursor down one line from its present position, 
in the same column. 


Moves the cursor up one line from its present position, in 
the same column. 


Moves the cursor down to the beginning of the next line. 


Carriage return; moves the cursor down to the beginning 
of the next line. 


Moves the cursor up to the beginning of the next line. 


Moves the cursor to the right, to the first character in 
the next word. 


Moves the cursor back to the first character of the previ- 
ous word. 


vi Quick Reference 
<e> Moves the cursor to the end of the current word. 


Positioning by Sentence 


<(> Moves the cursor to the beginning of the sentence. 


<)> Moves the cursor to the beginning of the next sentence. 


Positioning by Paragraph 
<{> Moves the cursor to the beginning of the paragraph. 
<}> Moves the cursor to the beginning of the next paragraph. 


Positioning in the Window 


<H> Moves the cursor to the first line on the screen, or 
“home.” 

<M> Moves the cursor to the middle line on the screen. 

<L> Moves the cursor to the last line on the screen. 


Commands for Positioning in the File 


Scrolling 

<"“f> Scrolls the screen forward a full window, revealing the 
window of text below the current window. 

<“d> Scrolls the screen down a half window, revealing lines of 
text below the current window. 

<“b> Scrolls the screen back a full window, revealing the win- 
dow of text above the current window. 

<“u> Scrolls the screen up a half window, revealing the lines 


of text above the current window. 
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Positioning on a Numbered Line 


<G> Moves the cursor to the beginning of the last line in the 
buffer. 
<nG> Moves the cursor to the beginning of the nth line of the 


file (n = line number). 


Searching for a Pattern 


[pattern Searchs forward in the buffer for the next occurrence of 
the pattern of text. Positions the cursor under the first 
character of the pattern. 


? pattern Searches backward in the buffer for the first occurrence 
of pattern of text. Positions the cursor under the first 
character of the pattern. 


<n> Repeats the last search command. 


<N> Repeats the search command in the opposite direction. 


Commands for Inserting Text 


<a> Enters text input mode and appends text after the cursor. 
<i> Enters text input mode and inserts text before the cursor. 
<o> Enters text input mode by opening a new line immedi- 


ately below the current line. 


<O> Enters text input mode by opening a new line immedi- 
ately above the current line. 


<ESC> Escape; returns to command mode from text input mode 
(entered with any of the above commands). 
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Commands for Deleting Text 


In Text Input Mode 


<BACKSPACE> Backspace; deletes the current character. 


<“w> 
<@> 


In Command Mode 


<x> 
<dw> 


<dd> 
<ndx> 


<D> 


Deletes the current word delimited by blanks. 


Erases the current line of text. 


Deletes the current character. 


Deletes a word (or part of a word) from the cursor 
through the next space or to the next punctuation. 


Deletes the current line. 


Deletes n number of text objects of type x, where x may 
be as a word, line, sentence, or paragraph. 


Deletes the current line from the cursor to the end of the 
line. 


Commands for Modifying Text 


Characters, Words, Text Objects 


<r> 
<s> 


<~> 


Replaces the current character. 


Deletes the current character and appends text until the 
<ESC> command is typed. 


Replaces all the characters in the current line. 


Changes upper case to lower case or lower case to upper 
case. 
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<cw> Replaces the current word or the remaining characters in 
the current word with new text, from the cursor to the 
next space or punctuation. 


<ce> Replaces all the characters in the current line. 


<nex> Replaces n number of text objects of type x, where x 
may be a word, line, sentence, or paragraph. 


<C> Replaces the remaining characters in the current line, 
from the cursor to the end of the line. 


Cutting and Pasting Text 


<p> Places the contents of the temporary buffer (containing 
the output of the last delete or yank command) into the 
text after the cursor or below the current line. 


<yy> Yanks (extracts) a specified line of text and puts it into 
| a temporary buffer. 


<nyx> Extracts a copy of m number of text objects of type x 
and puts it into a temporary buffer. 


<"lyx> Places a copy of text object x into a register named by a 
letter /. x may be a word, line, sentence, or paragraph. 


<"xp> Places the contents of register x after the cursor or below 
the current line. 


Other Commands 


Special Commands 


<“g> Gives the line number of current cursor position in the 
buffer and modification status of the file. 


<> Repeats the action performed by the last command. 
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<u> Undoes the effects of the last command. 

<U> Restores the current line to its state prior to present 
changes. 

<J> Joins the line immediately below the current line with 


the current line. 


<“|> Clears and redraws the current window. 


Line Editor Commands 


Tells vi that the next commands you issue will be line 
editor commands. 


:sh Temporarily returns to the shell to perform some shell 
commands without leaving vi. 


<“d> Escapes the temporary return to the shell and returns to 
vi so you can edit the current window. 


sn Goes to the nth line of the buffer. 


=x,zw filename Writes lines from the number x through the number z 
into a new file called filename. 


:$ Moves the cursor to the beginning of the last line in the 
buffer. 

3.590 Deletes all the lines from the current line to the last line. 

sr filename Inserts the contents of the file filename under the current 


line of the buffer. 


:s/text/new_text/ 
Replaces the first instance of text on the current line 
with new_text. 


:s/text/new_text/g 
Replace every occurrence of text on the current line with 
new_text. 


:g/text/s//new_text/g 
Changes every occurrence of text in the buffer to 
new_text. 
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Commands for Quitting vi 


<ZZ> 

:wq 

sw filename 
“q 

:w! filename 
-q 


:q! 


Writes the buffer to the file and quits vi. 
Writes the buffer to the file and quits vi. 


Writes the buffer to the new file filename and quits vi. 


Overwrites the existing file filename with the contents of 
the buffer and quits vi. 


Quits vi whether or not changes made to the buffer were 
written to a file. Does not incorporate changes made to 
the buffer since the last write (:w) command. 


Quits vi if changes made to the buffer were written to a 
file. 


Special Options for vi 
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vi filel file2 file3 


vi —r filel 


view file! 
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Enters three files into the vi buffer to be edited. Those 
files are filel, file2, and file3. 


When more than one file has been called on a single vi 
command line, writes the buffer to the file you are edit- 
ing and then calls the next file in the buffer (use :n only 
after :w). 


Restores the changes made to file! that were lost 
because of an interrupt in the system. 


Displays file] in the read-only mode of vi. Any changes 
made to the buffer will not be allowed to be written to 
the file. 


E: SUMMARY OF SHELL COMMAND LANGUAGE 


This appendix is a summary of the shell command language and program- 
ming constructs discussed in Chapter 7, "Shell Tutorial." The first section reviews 
metacharacters, special characters, input and output redirection, variables and 
processes. These are arranged by topic in the order that they were discussed in 
the chapter. The second section contains models of the shell programming con- 


structs. 


The Vocabulary of Shell Command Language 


Special Characters in the Shell 


seem Wa fer 


& 


° 
9 


Metacharacters; used to provide a shortcut to referencing file 
names, through pattern matching. 


Executes commands in the background mode. 


Sequentially executes several commands typed on one line, each 
pair separated by ;. 


Turns off the meaning of the immediately following special char- 
acter. 


Enclosing single quotes turn off the special meaning of all char- 
acters. 


Enclosing double quotes turn off the special meaning of all char- 
acters except $ and °. 


Redirecting Input and Output 


< 
> 


> a 


Redirects the contents of a file into a command. 


Redirects the output of a command into a new file, or replaces 
the contents of an existing file with the output. 


Redirects the output of a command so that it is appended to the 
end of a file. 
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Directs the output of one command so that it becomes the input 
of the next command. 


‘command Substitutes the output of the enclosed command in place of ‘com- 


mand. 


Executing and Terminating Processes 


batch 
at 

at —l 
at —r 
ps 

kill PID 


Submits the following commands to be processed at a time when 
the system load is at an acceptable level. <“d> ends the batch 
command. 


Submits the following commands to be executed at a specified 
time. <“d> ends the at command. 


Reports which jobs are currently in the at or batch queue. 
Removes the at or batch job from the queue. 
Reports the status of the shell processes. 


Terminates the shell process with the specified process ID (PID). 


nohup command list & 


Continues background processes after logging off. 


Making a File Accessible to the Shell 


952 


chmod u +x filename 


Gives the user permission to execute the file (useful for shell pro- 
gram files). 


my filename SHOME/bin/filename 


Moves your file to the bin directory in your home directory. This 
bin holds executable shell programs that you want to be accessi- 
ble. Make sure the PATH variable in your .profile file specifies 
this bin. If it does, the shell will search in SHOME/bin for your 
file when you try to execute it. If your PATH variable does not 
include your bin, the shell will not know where to find your file 
and your attempt to execute it will fail. 
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filename The name of a file that contains a shell program becomes the 
command that you type to run that shell program. 


Variables 


positional parameter 
A numbered variable used within a shell program to reference 
values automatically assigned by the shell from the arguments 
of the command line invoking the shell program. 


echo A command used to print the value of a variable on your ter- 
minal. 
S# A special parameter that contains the number of arguments 


with which the shell program has been executed. 
$* A special parameter that contains the values of all arguments 
with which the shell program has been executed. 


named variable 
A variable to which the user can give a name and assign 
values. 


Variables Used in the System 


HOME Denotes your home directory; the default variable for the cd 
command. 

PATH Defines the path your login shell follows to find commands. 

CDPATH Defines the search path for the ed command. 

MAIL Gives the name of the file containing your electronic mail. 

PS1 PS2 Define the primary and secondary prompt strings. 

TERM Defines the type of terminal. 


LOGNAME _ Login name of the user. 
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IFS Defines the internal field separators (normally the space, the 
| tab, and the carriage return). 


TERMINFO — Allows you to request that the curses and terminfo subroutines 
search a specified directory tree before searching the default 
directory for your terminal type. 


TZ Sets and maintains the local time zone. 


Shell Programming Constructs 


Here Document 


command <<! 


input lines 
' 


For Loop 


for variable<CR> 
in this list of values<CR> 
do the following commands<CR> 
command 1<CR> 
command 2<CR> 


.<CR> 
.<CR> 
last command <CR> 
done<CR> 
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While Loop 


while command list<CR> 
do<CR> 
command!1 <CR> 
command2<CR> 


.<CR> 
.<CR> 
last command <CR> 
done<CR> 


if... Then 


if this command is successful<CR> 
then command1 <CR> 
command2<CR> 
.<CR> 


.<CR> 
last command <CR> 
fi<CR> 
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if... Then... Else 


if command list<CR> 
then command list<CR> 


else command list<CR> 
fi<CR> 
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Case Construction 


case word <CR> 
in<CR> 
patternl1)<CR> 
command line 1<CR> 
.<CR> 
.<CR> 
last command line<CR> 


3<CR> 
pattern2) <CR> 
command line 1<CR> 


.<CR> 
.<CR> 
last command line<CR> 
3<CR> 
pattern3) <CR> 
command line 1<CR> 
.<CR> 
.<CR> 
last command line<CR> 
3<CR> 
esac <CR> 


break and continue Statements 


A break or continue statement forces the program to leave any loop and exe- 
cute the command following the end of the loop. 
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Setting the TERM Variable 


AT&T supports many types of terminals for use with the UNIX system. 
Because some commands are terminal dependent, the system must know what 
type of terminal you are using whenever you log in. The system determines the 
characteristics of your terminal by checking the value of a variable called TERM 
which holds the name of a terminal. If you have put the name of your terminal 
into this variable, the system will be able to execute all programs in a way that is 
suitable for your terminal. 


This method of telling the UNIX system what type of terminal you are using 
is called setting the terminal configuration. To set your terminal configuration, 
type the command lines shown on the following screen, substituting the name of 
your terminal for terminal_name. 


$ TERM =terminal_name<CR> 
$ export TERM<CR> 
$ tput init<CR> 


' These lines must be executed in the order shown; otherwise, they will not work. 
Also, this procedure must be repeated every time you log in. Therefore, most 
users put these lines into a file called .profile that is automatically executed every 
time they log in. For details about the .profile file, see Chapter 7. 


The first two lines in the screen tell the UNIX system shell what type of ter- 
minal you are using. The tput init command line instructs your terminal to 
behave in ways that the UNIX system expects a terminal of that type to behave. 
For example, it sets the terminal’s left margin and tabs, if those capabilities exist 
for the terminal. 
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The tput command uses the entry in this database for your terminal to make 
terminal dependent capabilities and information available to the shell. Because 
the values of these capabilities differ for each type of terminal, you must execute 
the tput init command line every time you change the TERM variable. 


For each terminal type, a set of capabilities is defined in a database. This 
database is usually found in either the /usr/lib/terminfo or /usr/lib,;COREterm 
directory, depending on the system. 


system administrator can tell you whether your system has the terminfo and/or 


jem Every system has at least one of these directories; some may have both. Your 
NOTE 
the .COREterm directory. 


The following sections describe how you can determine what terminal_names 
are acceptable. Further information about the capabilities in the terminfo data- 
base can be found on the terminfo(4) manual page in the Programmer’s Refer- 
ence Manual. 


Acceptable Terminal Names 


The UNIX system recognizes a wide range of terminal types. Before you put 
a terminal name into the TERM variable, you must make sure that your terminal 
is within that range. 


You must also verify that the name you put into the TERM variable is a 
recognized terminal name. There are usually at least two recognized names: the 
name of the manufacturer and the model number. However, there are several 
ways to represent these names: by varying the use of uppercase and lowercase, 
using abbreviations, and so on. Do not put a terminal name in the TERM vari- 
able until you have verified that the system recognizes it. 


The tput command provides a quick way to make sure your terminal is sup- 
ported by your system. Type: 


tput —Tterminal_name longname<CR> 


If your system supports your terminal it will respond with the complete name of 
your terminal. Otherwise, you will get an error message. 
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To find an acceptable name that you can put in the TERM variable, find a 
listing for your terminal in either of two directories: /usr/lib/terminfo or 
/usr/lib/,COREterm. Each of these directories is a collection of files with single- 
character names. Each file, in turn, holds a list of terminal names that all begin 
with the name of the file. (This name can be either a letter, such as the initial A 
in AT&T, or a number, such as the initial 5 in 5425.) Find the file whose name 
matches the first character of your terminal’s name. Then list the file’s contents 
and look for your terminal. 


You can also check with your system administrator for a list of terminals sup- 
ported by your system, and the acceptable names you can put in the TERM vari- 
able. 
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Suppose your terminal is an AT&T Teletype Model 5425. Your login is jim 
and you are currently in your home directory. First, you verify that your system 
supports your terminal by running the tput command. Next, you find an accept- 
able name for it in the /usr/lib/-COREterm/A directory. The following screen 
shows which commands you need to do this: 


$ tput —T5425 longname<CR> 
AT&T 4425/5425 
$ cd /usr/lib/,COREterm/A <CR> 
$ Is 

ATT4410 
ATT4415 
ATT4418 
ATT4424 
ATT4424-2 
ATT4425 
ATT4426 

ATT513 

ATT5410 
ATT5418 
ATT5420 
ATT5420-2 
ATT5425 
ATT5620 
ATT610BCT 
ATTPT505 

$ 


Now you are ready to put the name you found, ATT5425, in the TERM variable. 
Whenever you do this, you must also export TERM and execute tput init. 
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$ TERM =ATT5425<CR> 
$ export TERM<CR> 
$ tput init<CR> 


$ 


The UNIX system now knows what type of terminal you are using and will 
execute commands appropriately. 
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The area of the terminal screen in which you work and display files is similar 
to the window of a house: both are devices that frame a part of a whole (whether 
the world or a file) for viewing. For this reason, the working area of a terminal 
screen is called a window. Until now we have assumed that your terminal screen 
has only one window (the whole screen). However, some terminals allow you to 
create more than one window on your screen. Each window on a windowing ter- 
minal has its own shell and functions almost exactly like a separate terminal. To 
help you take advantage of this feature, the UNIX system provides a set of 
software tools called the Basic Windowing Utilities. 


We have already discussed how you can perform several tasks simultaneously 
with one screen by using tools such as background mode and the at command. 
With multiple windows you have the additional capability of working interactively 
with more than one process at a time. You can keep track of several processes at 
once or look at more than one file simultaneously. If you have a windowing ter- 
minal and the Basic Windowing Utilities are installed on your UNIX system, you 
can use the techniques described in this section to make efficient use of your ter- 
minal. 


Creating Windows 


To create a window you must draw it on your screen and set up the shell 
associated with it. The shell is the command interpreter; it allows you to work 
interactively with the UNIX system. Without a shell assigned to it, a window is 
simply a drawing on your screen. 


The layers command allows you to draw a window on any windowing termi- 
nal. If you execute it without any arguments, you must use the mouse to draw a 
window. If you give specifications for windows as arguments to the layers com- 
mand, you can program the drawing of windows and avoid using the mouse; your 
windows will be drawn automatically by the layers command. 
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Drawing Windows With a Mouse 


The easiest way to draw windows is with the mouse. First, enter the layers 
command. 


layers<CR> 


Next, press a button on your mouse; a pop-up menu of layer operations will 
appear on the screen. Choose the menu option for drawing windows (such as 
New), and use the mouse to draw one (see the terminal owner’s manual for 
instructions). 


To create more than one window, reinvoke the menu, make your selection, 
and draw with the mouse. (You cannot issue the layers command again.) In 
response, the terminal draws your window(s) on the screen and then waits for 
commands from the terminal. 


Drawing Windows Without a Mouse 


If you prefer to program the drawing of windows, you must first create a file 
containing the number and dimensions of the windows you want. Then run the 
layers command with the name of that file as an argument, and the —f option. 
This option tells the command to read your specifications file. The general com- 
mand line format is: 


layers —f file<CR> 


The specifications file must contain a line for each window you want, in the fol- 
lowing format: 


origin_x origin_y corner_x corner_y command list 


The first four fields of the line define the coordinates of the window. The origin_x 
and origin_y entries specify the position on the screen of the top, lefthand corner 
of the window, the point at which the command starts drawing. The corner_x 
and corner_y entries specify the position of the lower, righthand corner. 
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origin_x origin_y 


corner _x corner_y 


For example, to create a large rectangular window and a small one, write a 
specification file with the following lines: 


0 0 650 300 
650 0 792 175 


Windows drawn to these specifications will look like this: 


The fifth field of each line in your specifications file is command_list. Here 
you must enter a command that will assign a shell to the window. You can also 
assign a particular terminal type or an editor to the window in this field. 
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The command that allows you to assign a shell to your window is exec (short 
for execute). Enter this command with an argument specifying the type of shell 
you want to run in the window. To run the same type of shell that normally runs 
in your terminal, enter the following: 


exec SSHELL 
To run the standard UNIX system shell, enter 


exec /bin/sh 


You may also want your window to provide features that are available only 
on a type of terminal other than the one you are using. Specify the terminal type 
you want and assign it to the TERM variable. If you include this assignment in 
the commands list field, place it before the exec command. Separate all three 
requests (terminal type, TERM assignment, and exec command) with semi- 
colons, and leave spaces on both sides of each semi-colon. For example, say you 
want your window to provide the features of an HP 2621 terminal running the 
same type of shell that you normally run on your terminal. Type the 
commands list field in your specifications file as follows: 


jim ; exec $SSHELL 


To summarize, the specifications file must contain a line for each window that 
you want to create, and each line must include five fields: four coordinates for 
drawing the window and one command line that assigns a shell to the window. 
The command line may also include the assignment of a particular editor or ter- 
minal to the window. The following example of a specifications file incorporates 
the previous examples of fields: 


exec $SHELL 
exec /bin/sh 
jim ; exec $SHELL 


hp2621 ; TERM=hp2621 ; exec $SHELL 
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When your specifications file is ready, run the layers command as follows: 
layers —f specifications file<CR> 


The windows you have requested will be drawn on the screen, and the shells you 
assigned to them will be activated and ready for your commands. 


Working with Layers 


Once you have windows on your screens, you need to learn how to work with 
them: how to navigate among them, use each one as a terminal, and delete them. 
You can perform all these tasks by pressing different buttons on the mouse (see 
the owner’s manual for your terminal for specific instructions). 


Programmers who want to write their own programs for creating or using 
windows can do so with the library of functions called libwindows. (See the 
libwindows(3X) entry in the Programmer’s Reference Manual.) 
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acoustic coupler 
A device that permits transmission of data over an ordinary telephone 
line. When you place a telephone handset in the coupler, you link a 
computer at one end of the phone line to a peripheral device, such as a 
user terminal, at the other. 


address 
Generally, a number that indicates the location of information in the 
computer’s memory. In the UNIX system, the address is part of an 
editor command that specifies a line number or range. 


append mode 
A text editing mode in which the characters you type are entered as 
text into the text editor’s buffer. In this mode you enter (append) text 
after the current position in the buffer. See text input mode, compare 
with command mode and insert mode. 


argument 
The element of a command line that specifies data on which a command 
is to operate. Arguments follow the command name and can include 
numbers, letters, or text strings. For instance, in the command 
Ip —m myfile, lp is the command and myfile is the argument. See 
option. 


ASCII 
(pronounced as’-kee) American Standard Code for Information Inter- 
change, a standard for data transmission that is used in the UNIX sys- 
tem. ASCII assigns sets of Os and Is to represent 128 characters, 
including alphabetical characters, numerals, and standard special char- 
acters, such as #, $, %, and &. 


AT &T 3B Computers 
Computers manufactured by AT&T Technologies, Inc. 


background 
A type of program execution where you request the shell to run a com- 
mand away from the interaction between you and the computer ("in the 
background"). While this command runs, the shell prompts you to 
enter other commands through the terminal. 
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baud rate 
A measure of the speed of data transfer from a computer to a peri- 
pheral device (such as a terminal) or from one device to another. Com- 
mon baud rates are 300, 1200, 4800, and 9600. As a general guide, 
divide a baud rate by 10 to get the approximate number of English 
characters transmitted each second. 


buffer 
A temporary storage area of the computer used by text editors to make 
changes to a copy of an existing file. When you edit a file, its contents 
are read into a buffer, where you make changes to the text. For the 
changes to become a part of the permanent file, you must write the 
buffer contents back into the file. See permanent file. 


child directory 
See subdirectory. 


command 
The name of a file that contains a program that can be executed by the 
computer on request. Compiled programs and shell programs are forms 
of commands. 


command file 
See executable file. 


command language interpreter 
A program that acts as a direct interface between you and the com- 
puter. In the UNIX system, a program called the shell takes com- 
mands and translates them into a language understood by the computer. 


command line 
A line containing one or more commands, ended by typing a carriage 
return (<CR>). The line may also contain options and arguments for 
the commands. You type a command line to the shell to instruct the 
computer to perform one or more tasks. 
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command mode 
A text editing mode in which the characters you type are interpreted as 
editing commands. This mode permits actions such as moving around 
in the buffer, deleting text, or moving lines of text. See text input 
mode, compare with append mode and insert mode. 


context search 
A technique for locating a specified pattern of characters (called a 
string) when in a text editor. Editing commands that cause a context 
search scan the buffer, looking for a match with the string specified in 
the command. See string. 


control character 
A nonprinting character that is entered by holding down the control key 
and typing a character. Control characters are often used for special 
purposes. For instance, when viewing a long file on your screen with 
the cat command, typing control-s (*s) stops the display so you can read 
it, and typing control-q (“q) continues the display. 


current directory 
The directory in which you are presently working. You have direct 
access to all files and subdirectories contained in your current directory. 
The shorthand notation for the current directory is a dot (.). 


cursor 
A cue printed on the terminal screen that indicates the position at 
which you enter or delete a character. It is usually a rectangle or a 
blinking underscore character. 


default 
An automatically assigned value or condition that exists unless you 
explicitly change it. For example, the shell prompt string has a default 
value of $ unless you change it. 


delimiter 
A character that logically separates words or arguments on a command 
line. Two frequently used delimiters in the UNIX system are the space 
and the tab. 
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diagnostic 
A message printed at your terminal to indicate an error encountered 
while trying to execute some command or program. Generally, you 
need not respond directly to a diagnostic message. 


directory 
A type of file used to group and organize other files or directories. You 
cannot directly enter text or other data into a directory. (For more 
detail, see Appendix A, Summary of the File System.) 


disk 
A magnetic data storage device consisting of several round plates simi- 
lar to phonograph records. Disks store large amounts of data and allow 
quick access to any piece of data. 


electronic mail 
The feature of an operating system that allows computer users to 
exchange written messages via the computer. The UNIX system mail 
command provides electronic mail in which the addresses are the login 
names of users. 


environment 
The conditions under which you work while using the UNIX system. 
Your environment includes those things that personalize your login and 
allow you to interact in specific ways with the UNIX system and the 
computer. For example, your shell environment includes such things as 
your shell prompt string, specifics for backspace and erase characters, 
and commands for sending output from your terminal to the computer. 


erase character 
The character you type to delete the previous character you typed. The 
UNIX system default erase character is #; some users set the erase 
character to the BACKSPACE key. 


escape 
A means of getting into the shell from within a text editor or other pro- 
gram. 


execute 
The computer’s action of running a program or command and perform- 
ing the indicated operations. 
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executable file 
A file that can be processed or executed by the computer without any 
further translation. When you type in the file name, the commands in 
the file are executed. See shell procedure. 


file 
A collection of information in the form of a stream of characters. Files 
may contain data, programs, or other text. You access UNIX system 
files by name. See ordinary file, permanent file, and executable file. 


file name 
A sequence of characters that denotes a file. (In the UNIX system, a 
slash character (/) cannot be used as part of a file name.) 


file system 
A collection of files and the structure that links them together. The 
UNIX file system is a hierarchical structure. (For more detail, see 
Appendix A, Summary of the File System.) 


filter 
A command that reads the standard input, acts on it in some way, and 
then prints the result as standard output. 


final copy 
The completed, printed version of a file of text. 


foreground 
The normal type of command execution. When executing a command 
in foreground, the shell waits for one command to end before prompting 
you for another command. In other words, you enter something into the 
computer and the computer "replies" before you enter something else. 


full-duplex 
A type of data communication in which a computer system can transmit 
and receive data simultaneously. Terminals and modems usually have 
settings for half-duplex (one-way) and full-duplex communication; the 
UNIX system uses the full-duplex setting. 


full path name 
A path name that originates at the root directory of the UNIX system 
and leads to a specific file or directory. Each file and directory in the 
UNIX system has a unique full path name, sometimes called an abso- 
lute path name. See path name. 
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global 
A term that indicates the complete or entire file. While normal editor 
commands commonly act on only the first instance of a pattern in the 
file, global commands can perform the action on all instances in the file. 


hardware 
The physical machinery of a computer and any associated devices. 


hidden character 
One of a group of characters within the standard ASCII character set 
that are not printable. Characters such as backspace, escape, and 
<“d> are examples. 


home directory 
The directory in which you are located when you log in to the UNIX 
system; also known as your login directory. 


input/output 
The path by which information enters a computer system (input) and 
leaves the system (output). An input device that you use is the termi- 
nal keyboard and an output device is the terminal display. 


insert mode 
A text editing mode in which the characters you type are entered as 
text into the text editor’s buffer. In this mode you enter (insert) text 
before the current position in the buffer. See text input mode, compare 
with append mode and command mode. 


interactive 
Describes an operating system (such as the UNIX system) that can 
handle immediate-response communication between you and the com- 
puter. In other words, you interact with the computer from moment to 
moment. 


line editor 
An editing program in which text is operated upon on a line-by-line 
basis within a file. Commands for creating, changing, and removing 
text use line addresses to determine where in the file the changes are 
made. Changes can be viewed after they are made by displaying the 
lines changed. See text editor, compare with screen editor. 
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login 
The procedure used to gain access to the UNIX operating system. 


login directory 
See home directory. 


login name 
A string of characters used to identify a user. Your login name is 
different from other login names. 


log off 
The procedure used to exit from the UNIX operating system. 


metacharacter 
A subset of the set of special characters that have special meaning to 
the shell. The metacharacters are *, ?, and the pair [ ]. Metacharac- 
ters are used in patterns to match file names. 


mode 
In general, a particular type of operation (for example, an editor’s 
append mode). In relation to the file system, a mode is an octal number 
used to determine who can have access to your files and what kind of 
access they can have. See permissions. 


modem 
A device that connects a terminal and a computer by way of a tele- 
phone line. A modem converts digital signals to tones and converts 
tones back to digital signals, allowing a terminal and a computer to 
exchange data over standard telephone lines. 


multitasking 
The ability of an operating system to execute more than one program at 
a time. 


multiuser 
The ability of an operating system to support several users on the sys- 
tem at the same time. 


nroff 
A text formatter available as an add-on to the UNIX system. You can 
use the nroff program to produce a formatted on-line copy or a eae 
copy of a file. See text formatter. 
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operating system 
The software system on a computer under which all other software runs. 
The UNIX system is an operating system. 


option 
Special instructions that modify how a command runs. Options are a 
type of argument that follow a command and usually precede other 
arguments on the command line. By convention, an option is preceded 
by a minus sign (—); this distinguishes it from other arguments. You 
can specify more than one option for some commands given in the 
UNIX system. For example, in the command Is —1 —a directory, —] 
and —a are options that modify the ls command. See argument. 


ordinary file 
A file, containing text or data, that is not executable. See executable 
file. 


output 
Information processed in some fashion by a computer and delivered to 
you by way of a printer, a terminal, or a similar device. 


parameter 
A special type of variable used within shell programs to access values 
related to the arguments on the command line or the environment in 
which the program is executed. See positional parameter. 


parent directory 
The directory immediately above a subdirectory or file in the file system 
organization. The shorthand notation for the parent directory is two 
dots (..). 


parity 
A method used by a computer for checking that the data received 
matches the data sent. 


password 
A code word known only to you that is called for in the login process. 
The computer uses the password to verify that you may indeed use the 
system. 
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path name 
A sequence of directory names separated by the slash character (/) and 
ending with the name of a file or directory. The path name defines the 
connection path between some directory and the named file. 


peripheral device 
Auxiliary devices under the control of the main computer, used mostly 
for input, output, and storage functions. Some examples include termi- 
nals, printers, and disk drives. 


permanent file 
The data stored permanently in the file system structure. To change a 
permanent file, you can make use of a text editor, which maintains a 
temporary work space, or buffer, apart from the permanent files. Once 
changes have been made to the buffer, they must be written to the per- 
manent file to make the changes permanent. See buffer. 


permissions 
Access modes, associated with directories and files, that permit or deny 
system users the ability to read, write, and/or execute the directories 
and files. You determine the permissions for your directories and files 
by changing the mode for each one with the chmod command. 


pipe 
A method of redirecting the output of one command to be the input of 
another command. It is named for the character | that redirects the 
output. For example, the shell command who | we —I pipes output 
from the who command to the we command, telling you the total 
number of people logged into your UNIX system. 


pipeline 
A series of filters separated by | (the pipe character). The output of 
each filter becomes the input of the next filter in the line. The last filter 
in the pipeline writes to its standard output, or may be redirected to a 
file. See filter. 
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positional parameters 
Numbered variables used within a shell procedure to access the strings 
specified as arguments on the command line invoking the shell pro- 
cedure. The name of the shell procedure is positional parameter $0. 
See variable and shell procedure. 


prompt 
A cue displayed at your terminal by the shell, telling you that the shell 
is ready to accept your next request. The prompt can be a character or 
a series of characters. The UNIX system default prompt is the dollar 
sign character ($). 


printer 
An output device that prints the data it receives from the computer on 


paper. 


process 
Generally a program that is at some stage of execution. In the UNIX 
system, it also refers to the execution of a computer environment, 
including contents of memory, register values, name of the current 
directory, status of files, information recorded at login time, and various 
other items. 


program 
The instructions given to a computer on how to do a specific task. Pro- 
grams are user-executable software. 


read-ahead capability 
The ability of the UNIX system to read and interpret your input while 
sending output information to your terminal in response to previous 
input. The UNIX system separates input from output and processes 
each correctly. 


relative path name 
The path name to a file or directory which varies in relation to the 
directory in which you are currently working. 


remote system 
A system other than the one on which you are working. 


root 
The source directory of all files and directories in the file system; desig- 
nated by the slash character (/). 
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screen editor 
An editing program in which text is operated on relative to the position 
of the cursor on a visual display. Commands for entering, changing, 
and removing text involve moving the cursor to the area to be altered 
and performing the necessary operation. Changes are viewed on the 
terminal display as they are made. See text editor, compare with line 
editor. 


search pattern 
See string. 


search string 
See string. 


secondary prompt 
A cue displayed at your terminal by the shell to tell you that the com- 
mand typed in response to the primary prompt is incomplete. The 
UNIX system default secondary prompt is the "greater than" character 


(>). 


Shell 
A UNIX system program that handles the communication between you 
and the computer. The shell is also known as a command language 
interpreter because it translates your commands into a language under- 
standable by the computer. The shell accepts commands and causes the 
appropriate program to be executed. 


shell procedure 
An executable file that is not a compiled program. A shell procedure 
calls the shell to read and execute commands contained in a file. This 
lets you store a sequence of commands in a file for repeated use. It is 
also called a shell program or command file. See executable file. 


silent character 
See hidden character. 


software 7 
Instructions and programs that tell the computer what to do. Contrast 
with hardware. 
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source code 
The uncompiled version of a program written in a language such as C 
or Pascal. The source code must be translated to machine language by 
a program known as a compiler before the computer can execute the 
program. 


special character 
A character having special meaning to the shell program and used for 
common shell functions such as file redirection, piping, background exe- 
cution, and file name expansion. The special characters include <, >, 
ls, &, *, 2,1, and J. 


special file 
A file (called a device driver) used as an interface to an input/output 
device, such as a user terminal, a disk drive, or a line printer. 


standard input 
An open file that is normally connected directly to the keyboard. 
Standard input to a command normally goes from the keyboard to this 
file and then into the shell. You can redirect the standard input to 
come from another file instead of from the keyboard; use an argument 
in the form < file. Input to the command will then come from the 
specified file. 


standard output 
An open file that is normally connected directly to a primary output 
device, such as a terminal printer or screen. Standard output from the 
computer normally goes to this file and then to the output device. You 
can redirect the standard output into another file instead of to the 
printer or screen; use an argument in the form > file. Output will then 
go to the specified file. 


string 
Designation for a particular group or pattern of characters, such as a 
word or phrase, that may contain special characters. In a text editor, a 
context search interprets the special characters and attempts to match 
the specified pattern with a string in the editor buffer. 


string variable 
A sequence of characters that can be the value of a shell variable. See 
variable. 
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subdirectory 


A directory pointed to by a directory one level above it in the file sys- 
tem organization; also called a child directory. 


system administrator 


The person who monitors and controls the computer on which your 
UNIX system runs; sometimes referred to as a super-user. 


terminal 


An input/output device connected to a computer system, usually consist- 
ing of a keyboard with a video display or a printer. A terminal allows 
you to give the computer instructions and to receive information in 
response. 


text editor 


Software for creating, changing, or removing text with the aid of a com- 
puter. Most text editors have two modes--an input mode for typing in 
text and a command mode for moving or modifying text. Two examples 
are the UNIX system editors ed and vi. See line editor and screen edi- 
tor. 


text formatter 


A program that prepares a file of text for printed output. To make use 
of a text formatter, your file must also contain some special commands 
for structuring the final copy. These special commands tell the for- 
matter to justify margins, start new paragraphs, set up lists and tables, 
place figures, and so on. Two text formatters available as add-ons to 
your UNIX system are nroff and troff. 


text input mode 


A text editing mode in which the characters you type are entered as 
text into the text editor’s buffer. To execute a command, you must 
leave text input mode. See command mode, compare with append mode 
and insert mode. 


timesharing 


A method of operation in which several users share a common computer 
system seemingly simultaneously. The computer interacts with each 
user in sequence, but the high-speed operation makes it seem that the 
computer is giving each user its complete attention. 


580 USER’S GUIDE 


— Glossary 


tool 
A package of software programs. 

troff 
A text formatter available as an add-on to the UNIX system. The troff 
program drives a phototypesetter to produce high-quality printed text 
from a file. See text formatter. 

tty 
Historically, the abbreviation for a teletype terminal. Today, it is gen- 
erally used to denote a user terminal. 

user 


Anyone who uses a computer or an operating system. 


user-defined 
Something determined by the user. 


user-defined variable 
A named variable given a value by the user. See variable. 


UNIX system 
A general-purpose, multiuser, interactive, time-sharing operating system 
developed by AT&T Bell Laboratories. The UNIX system allows lim- 
ited computer resources to be shared by several users and efficiently 
organizes the user’s interface to a computer system. 


utility 
Software used to carry out routine functions or to assist a programmer 
or system user in establishing routine tasks. 


variable 
A symbol whose value may change. In the shell, a variable is a symbol 
representing some string of characters (a string value). Variables may 
be used in an interactive shell as well as within a shell procedure. 
Within a shell procedure, positional parameters and keyword parame- 
ters are two forms of variables. (Keyword parameters are discussed 
fully in Shell Commands and Programming.) 

video display terminal 
A terminal that uses a television-like screen (a monitor) to display 
information. A video display terminal can display information much 
faster than printing terminals. 
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visual editor 
See screen editor. 


working directory 
See current directory. 
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